@firfi/huly-mcp 0.49.6 → 0.50.0

package/dist/index.cjs

@@ -115697,7 +115697,11 @@ var init_issues = __esm({
           )}. Use status for exact project-specific status names.`
         })
       ),
-      assignee: Schema_exports.optional(PersonRefInput.annotate({ description: "Filter by assignee email or display name" })),
+      assignee: Schema_exports.optional(
+        PersonRefInput.annotate({
+          description: "Filter by assignee email, Person display name, or exact agent UserProfile title"
+        })
+      ),
       creator: Schema_exports.optional(
         PersonRefInput.annotate({
           description: "Filter by creator using a raw Person ID, exact email address, or exact display name. Ambiguous exact display names are rejected; unknown people return an empty list."
@@ -115806,7 +115810,9 @@ var init_issues = __esm({
       priority: Schema_exports.optional(
         IssuePrioritySchema.annotate({ description: "Issue priority (urgent, high, medium, low, no-priority)" })
       ),
-      assignee: Schema_exports.optional(PersonRefInput.annotate({ description: "Assignee email address or display name" })),
+      assignee: Schema_exports.optional(
+        PersonRefInput.annotate({ description: "Assignee email, Person display name, or exact agent UserProfile title" })
+      ),
       status: Schema_exports.optional(
         StatusName.annotate({ description: "Initial status (uses project default if not specified)" })
       ),
@@ -115848,7 +115854,9 @@ var init_issues = __esm({
       ),
       priority: Schema_exports.optional(IssuePrioritySchema.annotate({ description: "New issue priority" })),
       assignee: Schema_exports.optional(
-        Schema_exports.NullOr(PersonRefInput).annotate({ description: "New assignee email or display name (null to unassign)" })
+        Schema_exports.NullOr(PersonRefInput).annotate({
+          description: "New assignee email, Person display name, or exact agent UserProfile title (null to unassign)"
+        })
       ),
       status: Schema_exports.optional(StatusName.annotate({ description: "New status" })),
       taskType: Schema_exports.optional(
@@ -125061,7 +125069,7 @@ var init_unavailable_diagnostics = __esm({
 });
 
 // src/huly/errors-base.ts
-var HulyError, NoUpdateFieldsError, HulyConnectionError, HulyDataInvalidError, HulyUnavailableError, HulyAuthError, HulyModelNameSchema, HulyModelFieldSchema, HulyModelMetadataError;
+var HulyError, NoUpdateFieldsError, HulyConnectionOperation, HulyHttpStatus, HulyConnectionDiagnostic, HulyConnectionError, HTTP_ERROR_STATUS_PATTERN, hulyHttpStatusFromCause, makeOperationConnectionError, HulyDataInvalidError, HulyUnavailableError, HulyAuthError, HulyModelNameSchema, HulyModelFieldSchema, HulyModelMetadataError;
 var init_errors_base = __esm({
   "src/huly/errors-base.ts"() {
     "use strict";
@@ -125080,11 +125088,67 @@ var init_errors_base = __esm({
         return `${this.operation} requires at least one update field: ${this.fields.join(", ")}`;
       }
     };
+    HulyConnectionOperation = Schema_exports.Literals([
+      "findAll",
+      "findOne",
+      "findAllInModel",
+      "createDoc",
+      "conditionalCreateDoc",
+      "updateDoc",
+      "conditionalUpdateDoc",
+      "addCollection",
+      "updateCollection",
+      "removeCollection",
+      "removeDoc",
+      "conditionalRemoveDoc",
+      "createMixin",
+      "updateMixin",
+      "uploadMarkup",
+      "fetchMarkup",
+      "updateMarkup",
+      "searchFulltext",
+      "getWorkspaceMembers",
+      "getPersonInfo",
+      "updateWorkspaceRole",
+      "getWorkspaceInfo",
+      "getUserWorkspaces",
+      "createWorkspace",
+      "deleteWorkspace",
+      "getUserProfile",
+      "setMyProfile",
+      "createAccessLink",
+      "updateAllowReadOnlyGuests",
+      "updateAllowGuestSignUp",
+      "getRegionInfo"
+    ]);
+    HulyHttpStatus = Schema_exports.Int.check(Schema_exports.isBetween({ minimum: 100, maximum: 599 })).pipe(
+      Schema_exports.brand("HulyHttpStatus")
+    );
+    HulyConnectionDiagnostic = Schema_exports.Struct({
+      operation: HulyConnectionOperation,
+      httpStatus: Schema_exports.optionalKey(HulyHttpStatus)
+    });
     HulyConnectionError = class extends Schema_exports.TaggedError()("HulyConnectionError", {
       message: Schema_exports.String,
-      cause: Schema_exports.optional(Schema_exports.Defect())
+      cause: Schema_exports.optional(Schema_exports.Defect()),
+      diagnostic: Schema_exports.optionalKey(HulyConnectionDiagnostic)
     }) {
     };
+    HTTP_ERROR_STATUS_PATTERN = /\bHTTP(?: error)?\s+(?<status>[1-5]\d{2})\b/i;
+    hulyHttpStatusFromCause = (cause) => {
+      if (!(cause instanceof Error)) return void 0;
+      const statusText = HTTP_ERROR_STATUS_PATTERN.exec(cause.message)?.groups?.status;
+      if (statusText === void 0) return void 0;
+      return HulyHttpStatus.make(Number(statusText));
+    };
+    makeOperationConnectionError = (operation, cause) => {
+      const httpStatus = hulyHttpStatusFromCause(cause);
+      const message = `${operation} failed${httpStatus === void 0 ? "" : ` with HTTP ${httpStatus}`}`;
+      return new HulyConnectionError({
+        message,
+        diagnostic: { operation, ...httpStatus === void 0 ? {} : { httpStatus } }
+      });
+    };
     HulyDataInvalidError = class extends Schema_exports.TaggedError()("HulyDataInvalidError", {
       operation: Schema_exports.String,
       entity: Schema_exports.String,
@@ -125144,7 +125208,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.49.6" : "0.0.0-dev";
+    VERSION = true ? "0.50.0" : "0.0.0-dev";
   }
 });
 
@@ -125489,7 +125553,7 @@ var init_errors_contacts = __esm({
       { identifier: Schema_exports.String, matches: AmbiguousMatchCount }
     ) {
       get message() {
-        return `Person identifier '${this.identifier}' matched ${this.matches} people; use an exact email address instead`;
+        return `Person identifier '${this.identifier}' matched ${this.matches} people; use a unique Person display name or email address instead`;
       }
     };
     OrganizationNotFoundError = class extends Schema_exports.TaggedError()(
@@ -128260,7 +128324,7 @@ var init_tool_responses = __esm({
 });
 
 // src/mcp/error-mapping.ts
-var INVALID_PARAMS_TAGS, INTERNAL_ERROR_PREFIX, hulyUnavailableMessage, mapDomainErrorToMcp, isClientResolutionError, clientResolutionFailure, mapClientResolutionErrorToMcp, mapClientResolutionCauseToMcp, clientResolutionErrorMessage, clientResolutionCauseMessage, mapParseErrorToMcp, mapParseCauseToMcp, mapDomainCauseToMcp;
+var INVALID_PARAMS_TAGS, INTERNAL_ERROR_PREFIX, CONNECTION_ERROR_GUIDANCE, hulyConnectionMessage, hulyUnavailableMessage, mapDomainErrorToMcp, isClientResolutionError, clientResolutionFailure, redactResolutionDetail, mapClientResolutionErrorToMcp, mapClientResolutionCauseToMcp, clientResolutionErrorMessage, clientResolutionCauseMessage, mapParseErrorToMcp, mapParseCauseToMcp, mapDomainCauseToMcp;
 var init_error_mapping = __esm({
   "src/mcp/error-mapping.ts"() {
     "use strict";
@@ -128472,9 +128536,13 @@ var init_error_mapping = __esm({
     INTERNAL_ERROR_PREFIX = {
       FileUploadError: "File upload error",
       HulyStorageConfigError: "Storage configuration error",
-      HulyConnectionError: "Connection error",
       HulyAuthError: "Authentication error"
     };
+    CONNECTION_ERROR_GUIDANCE = "Verify HULY_URL, workspace, and network connectivity before retrying.";
+    hulyConnectionMessage = (error3) => {
+      const diagnostic = error3.diagnostic;
+      return diagnostic === void 0 ? `Connection error while communicating with Huly. ${CONNECTION_ERROR_GUIDANCE}` : `Connection error while communicating with Huly: ${diagnostic.operation} failed${diagnostic.httpStatus === void 0 ? "" : ` with HTTP ${diagnostic.httpStatus}`}. ${CONNECTION_ERROR_GUIDANCE}`;
+    };
     hulyUnavailableMessage = (error3) => {
       const failureGuidance = error3.failureKind === "timeout" ? " The request timed out; verify HULY_CONNECTION_TIMEOUT before retrying." : error3.failureKind === "dns" || error3.failureKind === "tls" ? " Verify the hostname, certificate, DNS, and proxy configuration before retrying." : "";
       if (isDefaultHulyCloudOrigin(error3.endpointOrigin)) {
@@ -128487,12 +128555,7 @@ var init_error_mapping = __esm({
         return createErrorResponse(hulyUnavailableMessage(error3), McpErrorCode.InternalError, error3._tag, warnings);
       }
       if (error3 instanceof HulyConnectionError) {
-        return createErrorResponse(
-          "Connection error while communicating with Huly. Verify HULY_URL, workspace, and network connectivity before retrying.",
-          McpErrorCode.InternalError,
-          error3._tag,
-          warnings
-        );
+        return createErrorResponse(hulyConnectionMessage(error3), McpErrorCode.InternalError, error3._tag, warnings);
       }
       if (INVALID_PARAMS_TAGS.has(error3._tag)) {
         return createErrorResponse(error3.message, McpErrorCode.InvalidParams, error3._tag, warnings);
@@ -128507,9 +128570,10 @@ var init_error_mapping = __esm({
       if (!Cause_exports.isCause(error3)) return void 0;
       return findRecoverableCauseFailure(error3, isClientResolutionError);
     };
+    redactResolutionDetail = (failure) => failure instanceof HulyConnectionError ? new HulyConnectionError({ message: "" }) : failure;
     mapClientResolutionErrorToMcp = (error3) => {
       const failure = clientResolutionFailure(error3);
-      return failure === void 0 ? mapDomainErrorToMcp(new HulyError({ message: "Failed to initialize Huly clients" })) : mapDomainErrorToMcp(failure);
+      return failure === void 0 ? mapDomainErrorToMcp(new HulyError({ message: "Failed to initialize Huly clients" })) : mapDomainErrorToMcp(redactResolutionDetail(failure));
     };
     mapClientResolutionCauseToMcp = (cause) => mapClientResolutionErrorToMcp(cause);
     clientResolutionErrorMessage = (error3) => mapClientResolutionErrorToMcp(error3).content[0].text;
@@ -178671,39 +178735,36 @@ var init_client = __esm({
           );
           const markupUrlConfig = { refUrl: UrlString.make(refUrl), imageUrl: UrlString.make(imageUrl) };
           const workbenchUrlConfig = { baseUrl: UrlString.make(config2.url), workspaceUrlSlug };
-          const withClient = (op, errorMsg) => Effect_exports.tryPromise({
-            try: () => op(client),
-            catch: (e) => new HulyConnectionError({ message: `${errorMsg}: ${String(e)}`, cause: e })
-          });
+          const withClient = (op, operation) => Effect_exports.tryPromise({ try: () => op(client), catch: (error3) => makeOperationConnectionError(operation, error3) });
           const operations = {
             getAccountUuid: () => accountUuid,
             getPrimarySocialId: () => primarySocialId,
             getSocialIds: () => socialIds,
             workbenchUrlConfig,
             markupUrlConfig,
-            findAll: (_class, query, options) => withClient((client2) => client2.findAll(_class, query, options), "findAll failed"),
-            findOne: (_class, query, options) => withClient((client2) => client2.findOne(_class, query, options), "findOne failed"),
+            findAll: (_class, query, options) => withClient((client2) => client2.findAll(_class, query, options), "findAll"),
+            findOne: (_class, query, options) => withClient((client2) => client2.findOne(_class, query, options), "findOne"),
             findAllInModel: (_class, query, options) => withClient(
               (client2) => Promise.resolve(client2.getModel().findAllSync(_class, query, options)),
-              "findAllInModel failed"
+              "findAllInModel"
             ),
-            createDoc: (_class, space, attributes, id2) => withClient((client2) => client2.createDoc(_class, space, attributes, id2), "createDoc failed"),
+            createDoc: (_class, space, attributes, id2) => withClient((client2) => client2.createDoc(_class, space, attributes, id2), "createDoc"),
             createDocIfNotMatched: (_class, space, attributes, id2, matchClass, matchQuery, scope3) => withClient(async (client2) => {
               const apply2 = client2.apply(scope3);
               apply2.notMatch(matchClass, matchQuery);
               await apply2.createDoc(_class, space, attributes, id2);
               return (await apply2.commit()).result ? "applied" : "condition-not-met";
-            }, "conditional createDoc failed"),
-            updateDoc: (_class, space, objectId, ops, retrieve) => withClient((client2) => client2.updateDoc(_class, space, objectId, ops, retrieve), "updateDoc failed"),
+            }, "conditionalCreateDoc"),
+            updateDoc: (_class, space, objectId, ops, retrieve) => withClient((client2) => client2.updateDoc(_class, space, objectId, ops, retrieve), "updateDoc"),
             updateDocIfMatched: (_class, space, objectId, matchQuery, operations2, scope3) => withClient(async (client2) => {
               const apply2 = client2.apply(scope3);
               apply2.match(_class, matchQuery);
               await apply2.updateDoc(_class, space, objectId, operations2);
               return (await apply2.commit()).result ? "applied" : "condition-not-met";
-            }, "conditional updateDoc failed"),
+            }, "conditionalUpdateDoc"),
             addCollection: (_class, space, attachedTo, attachedToClass, collection, attributes, id2) => withClient(
               (client2) => client2.addCollection(_class, space, attachedTo, attachedToClass, collection, attributes, id2),
-              "addCollection failed"
+              "addCollection"
             ),
             updateCollection: (_class, space, objectId, attachedTo, attachedToClass, collection, operations2, retrieve) => withClient(
               (client2) => client2.updateCollection(
@@ -178716,40 +178777,40 @@ var init_client = __esm({
                 operations2,
                 retrieve
               ),
-              "updateCollection failed"
+              "updateCollection"
             ),
             removeCollection: (_class, space, objectId, attachedTo, attachedToClass, collection) => withClient(
               (client2) => client2.removeCollection(_class, space, objectId, attachedTo, attachedToClass, collection),
-              "removeCollection failed"
+              "removeCollection"
             ),
-            removeDoc: (_class, space, objectId) => withClient((client2) => client2.removeDoc(_class, space, objectId), "removeDoc failed"),
+            removeDoc: (_class, space, objectId) => withClient((client2) => client2.removeDoc(_class, space, objectId), "removeDoc"),
             removeDocIfMatched: (_class, space, objectId, matchQuery, scope3) => withClient(async (client2) => {
               const apply2 = client2.apply(scope3);
               apply2.match(_class, matchQuery);
               await apply2.removeDoc(_class, space, objectId);
               return (await apply2.commit()).result ? "applied" : "condition-not-met";
-            }, "conditional removeDoc failed"),
+            }, "conditionalRemoveDoc"),
             createMixin: (objectId, objectClass, objectSpace, mixin, attributes) => withClient(
               (client2) => client2.createMixin(objectId, objectClass, objectSpace, mixin, attributes),
-              "createMixin failed"
+              "createMixin"
             ),
             updateMixin: (objectId, objectClass, objectSpace, mixin, attributes) => withClient(
               (client2) => client2.updateMixin(objectId, objectClass, objectSpace, mixin, attributes),
-              "updateMixin failed"
+              "updateMixin"
             ),
             uploadMarkup: (objectClass, objectId, objectAttr, markup, format5) => Effect_exports.tryPromise({
               try: () => markupOps.uploadMarkup(objectClass, objectId, objectAttr, markup, format5),
-              catch: (e) => new HulyConnectionError({ message: `uploadMarkup failed: ${String(e)}`, cause: e })
+              catch: (error3) => makeOperationConnectionError("uploadMarkup", error3)
             }),
             fetchMarkup: (objectClass, objectId, objectAttr, id2, format5) => Effect_exports.tryPromise({
               try: () => markupOps.fetchMarkup(objectClass, objectId, objectAttr, id2, format5),
-              catch: (e) => new HulyConnectionError({ message: `fetchMarkup failed: ${String(e)}`, cause: e })
+              catch: (error3) => makeOperationConnectionError("fetchMarkup", error3)
             }),
             updateMarkup: (objectClass, objectId, objectAttr, markup, format5) => Effect_exports.tryPromise({
               try: () => markupOps.updateMarkup(objectClass, objectId, objectAttr, markup, format5),
-              catch: (e) => new HulyConnectionError({ message: `updateMarkup failed: ${String(e)}`, cause: e })
+              catch: (error3) => makeOperationConnectionError("updateMarkup", error3)
             }),
-            searchFulltext: (query, options) => withClient((client2) => client2.searchFulltext(query, options), "searchFulltext failed")
+            searchFulltext: (query, options) => withClient((client2) => client2.searchFulltext(query, options), "searchFulltext")
           };
           return operations;
         })
@@ -179225,14 +179286,50 @@ var init_update_guards = __esm({
   }
 });
 
+// src/utils/assertions.ts
+var PAIR_LENGTH, AssertionError, assertExists, isExistent, assertAt, isNonEmpty3, isSingle, isPair, getOneOrNoneEffect;
+var init_assertions = __esm({
+  "src/utils/assertions.ts"() {
+    "use strict";
+    init_dist();
+    PAIR_LENGTH = 2;
+    AssertionError = class extends Error {
+      _tag = "AssertionError";
+      constructor(message) {
+        super(message);
+        this.name = "AssertionError";
+      }
+    };
+    assertExists = (value3, message) => {
+      if (value3 === null || value3 === void 0) {
+        throw new AssertionError(message ?? "Expected value to exist");
+      }
+      return value3;
+    };
+    isExistent = (value3) => value3 !== null && value3 !== void 0;
+    assertAt = (arr, index2, message) => {
+      return assertExists(arr[index2], message ?? `Expected array item at index ${index2}`);
+    };
+    isNonEmpty3 = (arr) => arr.length > 0;
+    isSingle = (arr) => arr.length === 1;
+    isPair = (arr) => arr.length === PAIR_LENGTH;
+    getOneOrNoneEffect = (arr, onTooMany) => {
+      if (arr.length === 0) return Effect_exports.succeed(Option_exports.none());
+      if (isSingle(arr)) return Effect_exports.succeed(Option_exports.some(arr[0]));
+      return Effect_exports.fail(onTooMany(arr));
+    };
+  }
+});
+
 // src/huly/operations/contacts-shared.ts
-var import_core38, isEmailIdentifier, findPersonById, findPersonByEmail, batchGetEmailsForPersons, findPersonIdsByEmailSearch, findPersonBySocialIdentityEmail, findPersonByExactEmail, findPersonByExactName, findPersonByExactEmailOrName, findPersonByIdOrExactEmailOrName, resolveEmployeeAccountUuid, findPersonByEmailOrName;
+var import_core38, isEmailIdentifier, findPersonById, findPersonByEmail, batchGetEmailsForPersons, findPersonIdsByEmailSearch, findPersonIdsByEmailChannelSearch, findPersonIdsByExactEmailSources, loadPeopleByIds, findPeopleByExactName, findPeopleByNameSearch, findPersonBySocialIdentityEmail, findPersonByExactEmail, findPersonByExactName, findPersonByExactEmailOrName, findPersonByIdOrExactEmailOrName, resolveEmployeeAccountUuid, findPersonByEmailOrName;
 var init_contacts_shared = __esm({
   "src/huly/operations/contacts-shared.ts"() {
     "use strict";
     import_core38 = __toESM(require_lib6(), 1);
     init_dist();
     init_shared();
+    init_assertions();
     init_errors4();
     init_huly_plugins();
     init_query_helpers();
@@ -179268,24 +179365,60 @@ var init_contacts_shared = __esm({
       return emailMap;
     });
     findPersonIdsByEmailSearch = (client, emailSearch) => Effect_exports.gen(function* () {
-      const value3 = { $like: `%${escapeLikeWildcards(emailSearch)}%` };
-      const [channels, socialIdentities] = yield* Effect_exports.all([
-        client.findAll(
-          contact.class.Channel,
-          hulyQuery({ provider: contact.channelProvider.Email, value: value3 })
-        ),
+      const [channelPersonIds, socialIdentities] = yield* Effect_exports.all([
+        findPersonIdsByEmailChannelSearch(client, emailSearch),
         client.findAll(
           contact.class.SocialIdentity,
-          hulyQuery({ type: import_core38.SocialIdType.EMAIL, value: value3 })
+          hulyQuery({
+            type: import_core38.SocialIdType.EMAIL,
+            value: { $like: `%${escapeLikeWildcards(emailSearch)}%` }
+          })
         )
       ]);
       return [
-        .../* @__PURE__ */ new Set([
-          ...channels.map((channel) => toRef(channel.attachedTo)),
-          ...socialIdentities.map((identity2) => toRef(identity2.attachedTo))
-        ])
+        .../* @__PURE__ */ new Set([...channelPersonIds, ...socialIdentities.map((identity2) => toRef(identity2.attachedTo))])
       ];
     });
+    findPersonIdsByEmailChannelSearch = (client, emailSearch) => Effect_exports.map(
+      client.findAll(
+        contact.class.Channel,
+        hulyQuery({
+          provider: contact.channelProvider.Email,
+          value: { $like: `%${escapeLikeWildcards(emailSearch)}%` }
+        })
+      ),
+      (channels) => [...new Set(channels.map((channel) => toRef(channel.attachedTo)))]
+    );
+    findPersonIdsByExactEmailSources = (client, email3) => Effect_exports.map(
+      Effect_exports.all([
+        client.findAll(
+          contact.class.SocialIdentity,
+          hulyQuery({ type: import_core38.SocialIdType.EMAIL, value: email3 })
+        ),
+        client.findAll(
+          contact.class.Channel,
+          hulyQuery({ value: email3, provider: contact.channelProvider.Email })
+        )
+      ]),
+      ([socialIdentities, channels]) => [
+        .../* @__PURE__ */ new Set([
+          ...socialIdentities.map((identity2) => toRef(identity2.attachedTo)),
+          ...channels.map((channel) => toRef(channel.attachedTo))
+        ])
+      ]
+    );
+    loadPeopleByIds = (client, personIds) => {
+      const uniqueIds = [...new Set(personIds)];
+      return uniqueIds.length === 0 ? Effect_exports.succeed([]) : Effect_exports.map(
+        client.findAll(contact.class.Person, hulyQuery({ _id: { $in: uniqueIds } })),
+        (people) => [...new Map(people.map((person) => [person._id, person])).values()]
+      );
+    };
+    findPeopleByExactName = (client, name) => client.findAll(contact.class.Person, hulyQuery({ name }));
+    findPeopleByNameSearch = (client, nameSearch) => client.findAll(
+      contact.class.Person,
+      hulyQuery({ name: { $like: `%${escapeLikeWildcards(nameSearch)}%` } })
+    );
     findPersonBySocialIdentityEmail = (client, email3) => Effect_exports.gen(function* () {
       const identity2 = yield* client.findOne(contact.class.SocialIdentity, {
         type: import_core38.SocialIdType.EMAIL,
@@ -179295,43 +179428,23 @@ var init_contacts_shared = __esm({
       return yield* client.findOne(contact.class.Person, { _id: identity2.attachedTo });
     });
     findPersonByExactEmail = (client, email3) => Effect_exports.gen(function* () {
-      const socialIdentities = yield* client.findAll(contact.class.SocialIdentity, {
-        type: import_core38.SocialIdType.EMAIL,
-        value: email3
-      });
-      const channels = yield* client.findAll(contact.class.Channel, {
-        value: email3,
-        provider: contact.channelProvider.Email
-      });
-      const personIds = [
-        .../* @__PURE__ */ new Set([
-          ...socialIdentities.map((identity2) => identity2.attachedTo),
-          ...channels.map((channel) => channel.attachedTo)
-        ])
-      ];
-      if (personIds.length === 0) {
-        return void 0;
-      }
-      const persons = yield* client.findAll(contact.class.Person, {
-        _id: { $in: personIds.map(toRef) }
-      });
-      if (persons.length === 0) {
-        return void 0;
-      }
-      if (persons.length > 1) {
-        return yield* new PersonIdentifierAmbiguousError({ identifier: email3, matches: Count.make(persons.length) });
-      }
-      return persons[0];
+      const personIds = yield* findPersonIdsByExactEmailSources(client, email3);
+      const persons = yield* loadPeopleByIds(client, personIds);
+      return Option_exports.getOrUndefined(
+        yield* getOneOrNoneEffect(
+          persons,
+          (matches) => new PersonIdentifierAmbiguousError({ identifier: email3, matches: Count.make(matches.length) })
+        )
+      );
     });
     findPersonByExactName = (client, name) => Effect_exports.gen(function* () {
-      const persons = yield* client.findAll(contact.class.Person, { name });
-      if (persons.length === 0) {
-        return void 0;
-      }
-      if (persons.length > 1) {
-        return yield* new PersonIdentifierAmbiguousError({ identifier: name, matches: Count.make(persons.length) });
-      }
-      return persons[0];
+      const persons = yield* findPeopleByExactName(client, name);
+      return Option_exports.getOrUndefined(
+        yield* getOneOrNoneEffect(
+          persons,
+          (matches) => new PersonIdentifierAmbiguousError({ identifier: name, matches: Count.make(matches.length) })
+        )
+      );
     });
     findPersonByExactEmailOrName = (client, identifier2) => isEmailIdentifier(identifier2) ? findPersonByExactEmail(client, identifier2) : findPersonByExactName(client, identifier2);
     findPersonByIdOrExactEmailOrName = (client, identifier2) => Effect_exports.gen(function* () {
@@ -179384,35 +179497,6 @@ var init_contacts_shared = __esm({
   }
 });
 
-// src/utils/assertions.ts
-var PAIR_LENGTH, AssertionError, assertExists, isExistent, assertAt, isNonEmpty3, isSingle, isPair;
-var init_assertions = __esm({
-  "src/utils/assertions.ts"() {
-    "use strict";
-    PAIR_LENGTH = 2;
-    AssertionError = class extends Error {
-      _tag = "AssertionError";
-      constructor(message) {
-        super(message);
-        this.name = "AssertionError";
-      }
-    };
-    assertExists = (value3, message) => {
-      if (value3 === null || value3 === void 0) {
-        throw new AssertionError(message ?? "Expected value to exist");
-      }
-      return value3;
-    };
-    isExistent = (value3) => value3 !== null && value3 !== void 0;
-    assertAt = (arr, index2, message) => {
-      return assertExists(arr[index2], message ?? `Expected array item at index ${index2}`);
-    };
-    isNonEmpty3 = (arr) => arr.length > 0;
-    isSingle = (arr) => arr.length === 1;
-    isPair = (arr) => arr.length === PAIR_LENGTH;
-  }
-});
-
 // src/huly/operations/spaces-shared.ts
 var import_core39, spaceClass, sortStrings, uniqueSorted, mergeUniqueSortedAccountUuids, removeAccountUuids, arraysEqual, optionalString, optionalObjectClassName, RoleAssignmentStorageSchema, RoleAssignmentStorageObjectSchema, parseRoleAssignmentStorageObject, validStoredAccountUuid, parsedSpaceRoleAssignmentEntry, spaceRoleAssignmentSource, roleAssignmentsMalformedError, readSpaceRoleAssignmentEntries, spaceRoleAssignmentEntries, hasSpaceRoleAssignmentMixin, strictSpaceRoleAssignments, roleAssignmentDegradationMessage, spaceRoleAssignmentsMixin, applySpaceFilters, findSpace, spaceMapById, updateSpaceDoc, resolveMembers;
 var init_spaces_shared = __esm({
@@ -183437,10 +183521,7 @@ var init_workspace_client = __esm({
             { url: config2.url, auth: config2.auth, workspace: config2.workspace },
             sdk
           );
-          const withClient = (op, errorMsg) => Effect_exports.tryPromise({
-            try: () => op(client),
-            catch: (e) => new HulyConnectionError({ message: `${errorMsg}: ${String(e)}`, cause: e })
-          });
+          const withClient = (op, operation) => Effect_exports.tryPromise({ try: () => op(client), catch: (error3) => makeOperationConnectionError(operation, error3) });
           const accessLinkIdentityOptions = (options) => ({
             ...options.firstName !== void 0 ? { firstName: options.firstName } : {},
             ...options.lastName !== void 0 ? { lastName: options.lastName } : {},
@@ -183454,25 +183535,19 @@ var init_workspace_client = __esm({
           });
           const toAccountClientAccessLinkOptions = (options) => options === void 0 ? void 0 : { ...accessLinkIdentityOptions(options), ...accessLinkTimingOptions(options) };
           const operations = {
-            getWorkspaceMembers: () => withClient((c) => c.getWorkspaceMembers(), "Failed to get workspace members"),
-            getPersonInfo: (account) => withClient((c) => c.getPersonInfo(account), "Failed to get person info"),
-            updateWorkspaceRole: (account, role) => withClient((c) => c.updateWorkspaceRole(account, role), "Failed to update workspace role"),
-            getWorkspaceInfo: (updateLastVisit) => withClient((c) => c.getWorkspaceInfo(updateLastVisit), "Failed to get workspace info"),
-            getUserWorkspaces: () => withClient((c) => c.getUserWorkspaces(), "Failed to get user workspaces"),
-            createWorkspace: (name, region) => withClient((c) => c.createWorkspace(name, region), "Failed to create workspace"),
-            deleteWorkspace: () => withClient((c) => c.deleteWorkspace(), "Failed to delete workspace"),
-            getUserProfile: (personUuid) => withClient((c) => c.getUserProfile(personUuid), "Failed to get user profile"),
-            setMyProfile: (profile) => withClient((c) => c.setMyProfile(profile), "Failed to set my profile"),
-            createAccessLink: (role, options) => withClient(
-              (c) => c.createAccessLink(role, toAccountClientAccessLinkOptions(options)),
-              "Failed to create access link"
-            ),
-            updateAllowReadOnlyGuests: (readOnlyGuestsAllowed) => withClient(
-              (c) => c.updateAllowReadOnlyGuests(readOnlyGuestsAllowed),
-              "Failed to update read-only guest setting"
-            ),
-            updateAllowGuestSignUp: (guestSignUpAllowed) => withClient((c) => c.updateAllowGuestSignUp(guestSignUpAllowed), "Failed to update guest sign-up setting"),
-            getRegionInfo: () => withClient((c) => c.getRegionInfo(), "Failed to get region info")
+            getWorkspaceMembers: () => withClient((c) => c.getWorkspaceMembers(), "getWorkspaceMembers"),
+            getPersonInfo: (account) => withClient((c) => c.getPersonInfo(account), "getPersonInfo"),
+            updateWorkspaceRole: (account, role) => withClient((c) => c.updateWorkspaceRole(account, role), "updateWorkspaceRole"),
+            getWorkspaceInfo: (updateLastVisit) => withClient((c) => c.getWorkspaceInfo(updateLastVisit), "getWorkspaceInfo"),
+            getUserWorkspaces: () => withClient((c) => c.getUserWorkspaces(), "getUserWorkspaces"),
+            createWorkspace: (name, region) => withClient((c) => c.createWorkspace(name, region), "createWorkspace"),
+            deleteWorkspace: () => withClient((c) => c.deleteWorkspace(), "deleteWorkspace"),
+            getUserProfile: (personUuid) => withClient((c) => c.getUserProfile(personUuid), "getUserProfile"),
+            setMyProfile: (profile) => withClient((c) => c.setMyProfile(profile), "setMyProfile"),
+            createAccessLink: (role, options) => withClient((c) => c.createAccessLink(role, toAccountClientAccessLinkOptions(options)), "createAccessLink"),
+            updateAllowReadOnlyGuests: (readOnlyGuestsAllowed) => withClient((c) => c.updateAllowReadOnlyGuests(readOnlyGuestsAllowed), "updateAllowReadOnlyGuests"),
+            updateAllowGuestSignUp: (guestSignUpAllowed) => withClient((c) => c.updateAllowGuestSignUp(guestSignUpAllowed), "updateAllowGuestSignUp"),
+            getRegionInfo: () => withClient((c) => c.getRegionInfo(), "getRegionInfo")
           };
           return operations;
         })
@@ -193821,7 +193896,7 @@ var init_persons = __esm({
     };
     applyPersonEmailSearch = (client, query, emailSearch) => Effect_exports.gen(function* () {
       if (emailSearch === void 0 || emailSearch === "") return true;
-      const matchingPersonIds = yield* findPersonIdsByEmailSearch(client, emailSearch);
+      const matchingPersonIds = yield* findPersonIdsByEmailSearch(client, NonEmptyString2.make(emailSearch));
       if (matchingPersonIds.length === 0) return false;
       query._id = { $in: matchingPersonIds };
       return true;
@@ -199859,319 +199934,947 @@ var init_issues_parent = __esm({
   }
 });
 
-// src/huly/operations/issues-move.ts
-var import_core87, import_tracker3, issueTargetClass, addLabel, moveIssue, updateDescendantParents;
-var init_issues_move = __esm({
-  "src/huly/operations/issues-move.ts"() {
+// src/huly/operations/issue-native-references.ts
+var renderIssueDescriptionForWrite;
+var init_issue_native_references = __esm({
+  "src/huly/operations/issue-native-references.ts"() {
     "use strict";
-    import_core87 = __toESM(require_lib6(), 1);
-    import_tracker3 = __toESM(require_lib25(), 1);
     init_dist();
-    init_shared();
-    init_tags();
-    init_huly_plugins();
-    init_issues_parent();
-    init_issues_shared();
-    init_query_helpers();
-    init_sdk_boundary();
-    init_tags_shared();
-    issueTargetClass = TagTargetClass.make(String(tracker.class.Issue));
-    addLabel = (params2) => Effect_exports.gen(function* () {
-      const { issue: issue2, project } = yield* findProjectAndIssue(params2);
-      const labelTitle = TagIdentifier.make(params2.label.trim());
-      const tag2 = yield* ensureTagElement({
-        targetClass: issueTargetClass,
-        titleOrId: labelTitle,
-        color: params2.color,
-        fallbackCategory: tracker.category.Other
-      });
-      const result3 = yield* attachTagReference({
-        tag: tag2,
-        objectId: issue2._id,
-        objectClass: tracker.class.Issue,
-        space: project._id,
-        collection: "labels",
-        matchTitleCaseInsensitive: true
-      });
-      return { identifier: IssueIdentifier.make(issue2.identifier), labelAdded: result3.attached };
-    });
-    moveIssue = (params2) => Effect_exports.gen(function* () {
-      const { client, issue: issue2, project } = yield* findProjectAndIssue(params2);
-      const oldParentIsIssue = hasConcreteIssueParent(issue2);
-      const newParentParam = params2.newParent;
-      const target = newParentParam !== null ? yield* Effect_exports.gen(function* () {
-        const parentIssue = yield* findIssueInProject(client, project, newParentParam);
-        return {
-          _tag: "Child",
-          identifier: IssueIdentifier.make(parentIssue.identifier),
-          issue: parentIssue,
-          parent: childIssueParent(parentIssue, project._id)
-        };
-      }) : { _tag: "TopLevel", parent: topLevelIssueParent() };
-      if (target._tag === "Child") {
-        yield* attachIssueChild(client, project._id, issue2._id, target.issue, {});
-      } else {
-        yield* client.updateDoc(tracker.class.Issue, project._id, issue2._id, {
-          attachedTo: toRef(target.parent.attachedTo),
-          attachedToClass: target.parent.attachedToClass,
-          collection: target.parent.collection,
-          parents: target.parent.parents
-        });
-      }
-      if (oldParentIsIssue) {
-        yield* client.updateDoc(
-          tracker.class.Issue,
-          project._id,
-          // issue.attachedTo is Ref<Doc>; for sub-issues it points to the parent issue.
-          // Cast needed because updateDoc expects Ref<HulyIssue> but attachedTo is Ref<Doc>.
-          toRef(issue2.attachedTo),
-          { $inc: { subIssues: -1 } }
-        );
-      }
-      if (issue2.subIssues > 0) {
-        yield* updateDescendantParents(client, project._id, issue2, target.parent.parents);
-      }
-      const result3 = { identifier: IssueIdentifier.make(issue2.identifier), moved: true };
-      if (target._tag === "Child") {
-        return { ...result3, newParent: target.identifier };
-      }
-      return result3;
-    });
-    updateDescendantParents = (client, spaceId, parentIssue, parentNewParents) => Effect_exports.gen(function* () {
-      const thisParentInfo = {
-        parentId: parentIssue._id,
-        identifier: parentIssue.identifier,
-        parentTitle: parentIssue.title,
-        space: spaceId
-      };
-      const children = yield* client.findAll(
-        tracker.class.Issue,
-        hulyQuery({ attachedTo: parentIssue._id, space: spaceId })
-      );
-      for (const child of children) {
-        const childNewParents = [...parentNewParents, thisParentInfo];
-        yield* client.updateDoc(tracker.class.Issue, spaceId, child._id, { parents: childNewParents });
-        if (child.subIssues > 0) {
-          yield* updateDescendantParents(client, spaceId, child, childNewParents);
-        }
+    init_client();
+    init_errors4();
+    init_native_reference_markup();
+    renderIssueDescriptionForWrite = (description) => Effect_exports.gen(function* () {
+      const client = yield* HulyClient;
+      const rendered = renderMarkdownWithNativeReferencesForWrite(description, client.markupUrlConfig, "description");
+      if (rendered._tag === "malformed") {
+        return yield* new IssueReferenceError({ reason: rendered.reason });
       }
+      return rendered.rendered;
     });
   }
 });
 
-// src/huly/operations/issue-creators-read.ts
-var parsePersonRef, uniqueCreatorIds, creatorRef, creatorForIssue, loadIssueCreatorIndex;
-var init_issue_creators_read = __esm({
-  "src/huly/operations/issue-creators-read.ts"() {
+// src/huly/operations/issue-assignee-resolution.ts
+var findExactPeople, findFuzzyPeople, oneAssigneeOrNone, findIssueAssignee;
+var init_issue_assignee_resolution = __esm({
+  "src/huly/operations/issue-assignee-resolution.ts"() {
     "use strict";
     init_dist();
-    init_issues();
-    init_tool_warnings();
-    init_diagnostics();
+    init_shared();
+    init_assertions();
+    init_errors4();
     init_huly_plugins();
     init_contacts_shared();
     init_query_helpers();
     init_sdk_boundary();
-    parsePersonRef = Schema_exports.decodeUnknownOption(PersonRefSchema);
-    uniqueCreatorIds = (issues) => [
-      ...new Set(issues.flatMap((issue2) => issue2.createdBy === void 0 ? [] : [issue2.createdBy]))
-    ];
-    creatorRef = (person, emailByPerson) => parsePersonRef({
-      id: person._id,
-      ...person.name.trim() === "" ? {} : { name: person.name },
-      ...emailByPerson.has(person._id) ? { email: emailByPerson.get(person._id) } : {}
+    findExactPeople = Effect_exports.fn("IssueAssigneeResolution.findExactPeople")(function* (client, identifier2) {
+      const [emailPersonIds, namedPeople, profiles] = yield* Effect_exports.all([
+        findPersonIdsByExactEmailSources(client, identifier2),
+        findPeopleByExactName(client, identifier2),
+        client.findAll(
+          toClassRef(contact.class.UserProfile),
+          hulyQuery({ title: identifier2 })
+        )
+      ]);
+      return yield* loadPeopleByIds(client, [
+        ...emailPersonIds,
+        ...namedPeople.map((person) => person._id),
+        ...profiles.map((profile) => profile.person)
+      ]);
     });
-    creatorForIssue = (index2, issue2) => issue2.createdBy === void 0 ? void 0 : index2.get(issue2.createdBy);
-    loadIssueCreatorIndex = (client, issues) => Effect_exports.gen(function* () {
-      const creatorIds = uniqueCreatorIds(issues);
-      if (creatorIds.length === 0) return /* @__PURE__ */ new Map();
-      const identities = yield* client.findAll(
-        contact.class.SocialIdentity,
-        hulyQuery({ _id: { $in: creatorIds.map(toSocialIdentityRef) } })
-      );
-      const personIds = [...new Set(identities.map((identity2) => identity2.attachedTo))];
-      const persons = personIds.length === 0 ? [] : yield* client.findAll(
-        contact.class.Person,
-        hulyQuery({ _id: { $in: personIds.map(toRef) } })
-      );
-      const emailByPerson = yield* batchGetEmailsForPersons(
-        client,
-        persons.map((person) => person._id)
-      );
-      const personById = new Map(persons.map((person) => [person._id, person]));
-      const index2 = /* @__PURE__ */ new Map();
-      for (const identity2 of identities) {
-        const person = personById.get(identity2.attachedTo);
-        if (person === void 0) continue;
-        const parsed = creatorRef(person, emailByPerson);
-        if (Option_exports.isSome(parsed)) index2.set(identity2._id, parsed.value);
-      }
-      const unresolvedCount = creatorIds.filter((creatorId) => !index2.has(creatorId)).length;
-      if (unresolvedCount > 0) {
-        const diagnostics = yield* Diagnostics;
-        yield* diagnostics.warnAgent({
-          code: IssueCreatorMetadataDegradedWarningCode,
-          message: `${unresolvedCount} unresolved issue creator reference(s) were omitted from issue results.`
-        });
-      }
-      return index2;
+    findFuzzyPeople = Effect_exports.fn("IssueAssigneeResolution.findFuzzyPeople")(function* (client, identifier2) {
+      const [emailPersonIds, namedPeople] = yield* Effect_exports.all([
+        findPersonIdsByEmailChannelSearch(client, identifier2),
+        findPeopleByNameSearch(client, identifier2)
+      ]);
+      return yield* loadPeopleByIds(client, [...emailPersonIds, ...namedPeople.map((person) => person._id)]);
+    });
+    oneAssigneeOrNone = (identifier2, people) => getOneOrNoneEffect(
+      people,
+      (matches) => new PersonIdentifierAmbiguousError({ identifier: identifier2, matches: Count.make(matches.length) })
+    );
+    findIssueAssignee = Effect_exports.fn("IssueAssigneeResolution.findIssueAssignee")(function* (client, identifier2) {
+      const exactPeople = yield* findExactPeople(client, identifier2);
+      const exactPerson = yield* oneAssigneeOrNone(identifier2, exactPeople);
+      if (Option_exports.isSome(exactPerson)) return exactPerson;
+      return yield* oneAssigneeOrNone(identifier2, yield* findFuzzyPeople(client, identifier2));
     });
   }
 });
 
-// src/huly/operations/issue-labels-read.ts
-var IssueLabelAttachmentBoundarySchema, NormalizedLabelTitle, decodeAttachment, decodeTitle, decodeColor, toDocRef2, toIssueRef, normalizeLabelTitle, COLOR_SORT_WIDTH, compareStrings, candidateSortKey, compareCandidates, toCandidate3, projectionCandidate, projectionDegradationReason, projectCandidateGroup, buildIssueLabelIndex, countReason, degradationMessage, labelsForIssue, issueIdsMatchingLabel, loadIssueLabelIndex;
-var init_issue_labels_read = __esm({
-  "src/huly/operations/issue-labels-read.ts"() {
+// src/huly/operations/issues-write-shared.ts
+var resolveAssignee, TASK_TYPE_DISCOVERY_HINT, taskTypeMatches, describeTaskTypeOptions, mergeTaskTypes2, resolveTaskTypeWorkflow, validStatusNames, resolveStatusForTaskType, chooseStatusForTaskType;
+var init_issues_write_shared = __esm({
+  "src/huly/operations/issues-write-shared.ts"() {
     "use strict";
     init_dist();
-    init_shared();
-    init_tool_warnings();
-    init_diagnostics();
+    init_normalize();
+    init_errors4();
     init_huly_plugins();
+    init_issue_assignee_resolution();
     init_query_helpers();
-    init_sdk_boundary();
-    IssueLabelAttachmentBoundarySchema = Schema_exports.Struct({
-      _id: TagReferenceId,
-      attachedTo: IssueId,
-      title: Schema_exports.optional(Schema_exports.Unknown),
-      color: Schema_exports.optional(Schema_exports.Unknown)
-    }).annotate({
-      title: "IssueLabelAttachmentBoundary",
-      description: "Partial Huly TagReference fields used to project issue labels. Missing or malformed presentation fields are handled by stable projection rules."
+    resolveAssignee = (client, assigneeIdentifier) => Effect_exports.gen(function* () {
+      const person = yield* findIssueAssignee(client, assigneeIdentifier);
+      return yield* Option_exports.match(person, {
+        onNone: () => Effect_exports.fail(new PersonNotFoundError({ identifier: assigneeIdentifier })),
+        onSome: Effect_exports.succeed
+      });
     });
-    NormalizedLabelTitle = NonEmptyString2.pipe(Schema_exports.brand("NormalizedLabelTitle"));
-    decodeAttachment = Schema_exports.decodeUnknownResult(IssueLabelAttachmentBoundarySchema);
-    decodeTitle = Schema_exports.decodeUnknownResult(NonEmptyString2);
-    decodeColor = Schema_exports.decodeUnknownResult(ColorCode);
-    toDocRef2 = (id2) => toRef(IssueId.make(id2));
-    toIssueRef = toRef;
-    normalizeLabelTitle = (title) => NormalizedLabelTitle.make(title.toLowerCase());
-    COLOR_SORT_WIDTH = 2;
-    compareStrings = (left, right) => Number(left > right) - Number(left < right);
-    candidateSortKey = (candidate) => [
-      candidate.normalizedTitle,
-      candidate.color === void 0 ? "1" : "0",
-      candidate.title,
-      String(candidate.color).padStart(COLOR_SORT_WIDTH, "0"),
-      candidate.referenceId
-    ].join("\0");
-    compareCandidates = (left, right) => compareStrings(candidateSortKey(left), candidateSortKey(right));
-    toCandidate3 = (input) => {
-      const attachment2 = decodeAttachment(input);
-      if (Result_exports.isFailure(attachment2)) {
-        return { _tag: "Rejected", degradationReason: "malformed_attachment" };
-      }
-      const title = decodeTitle(attachment2.success.title);
-      if (Result_exports.isFailure(title)) {
-        return { _tag: "Rejected", degradationReason: "missing_or_malformed_title" };
+    TASK_TYPE_DISCOVERY_HINT = "Use list_task_types or get_project_type to discover valid task types and statuses.";
+    taskTypeMatches = (taskType, taskTypeRef) => String(taskType._id) === String(taskTypeRef) || normalizeForComparison(taskType.name) === normalizeForComparison(taskTypeRef);
+    describeTaskTypeOptions = (taskTypes) => taskTypes.length === 0 ? "No task types are configured for this project type." : `Available task types: ${taskTypes.map((taskType) => `${taskType.name} (${taskType._id})`).join(", ")}.`;
+    mergeTaskTypes2 = (first, second) => {
+      const taskTypesById = /* @__PURE__ */ new Map();
+      for (const taskType of [...first, ...second]) {
+        taskTypesById.set(String(taskType._id), taskType);
       }
-      const colorInput = attachment2.success.color;
-      const color = colorInput === void 0 ? void 0 : decodeColor(colorInput);
-      const candidate = {
-        referenceId: attachment2.success._id,
-        issueId: attachment2.success.attachedTo,
-        title: title.success,
-        normalizedTitle: normalizeLabelTitle(title.success),
-        ...color !== void 0 && Result_exports.isSuccess(color) ? { color: color.success } : {}
-      };
-      return color !== void 0 && Result_exports.isFailure(color) ? { _tag: "DegradedSuccess", candidate, degradationReason: "invalid_color" } : { _tag: "Success", candidate };
+      return [...taskTypesById.values()];
     };
-    projectionCandidate = (projection) => projection._tag === "Rejected" ? [] : [projection.candidate];
-    projectionDegradationReason = (projection) => {
-      switch (projection._tag) {
-        case "Success":
-          return [];
-        case "DegradedSuccess":
-        case "Rejected":
-          return [projection.degradationReason];
+    resolveTaskTypeWorkflow = (client, project, projectType, projectStatuses, taskTypeRef, projectIdentifier) => Effect_exports.gen(function* () {
+      const workflowProjectType = projectType ?? (yield* client.findOne(task.class.ProjectType, hulyQuery({ _id: project.type })));
+      if (workflowProjectType === void 0) {
+        return yield* Effect_exports.fail(
+          new HulyError({
+            message: `Project '${projectIdentifier}' does not expose a project type/workflow, so taskType cannot be resolved. ${TASK_TYPE_DISCOVERY_HINT}`
+          })
+        );
       }
-    };
-    projectCandidateGroup = (candidates) => {
-      const sorted = [...candidates].sort(compareCandidates);
-      return sorted.filter(
-        (candidate, index2) => sorted.findIndex((other) => other.normalizedTitle === candidate.normalizedTitle) === index2
-      ).map((candidate) => ({
-        title: candidate.title,
-        ...candidate.color === void 0 ? {} : { color: candidate.color }
-      }));
-    };
-    buildIssueLabelIndex = (attachments) => {
-      const projections = attachments.map(toCandidate3);
-      const candidates = projections.flatMap(projectionCandidate);
-      const issueIds = [...new Set(candidates.map((candidate) => candidate.issueId))];
-      return {
-        byIssueId: new Map(
-          issueIds.map((issueId) => [
-            issueId,
-            projectCandidateGroup(candidates.filter((candidate) => candidate.issueId === issueId))
-          ])
-        ),
-        degradationReasons: projections.flatMap(projectionDegradationReason)
-      };
-    };
-    countReason = (reasons, reason) => reasons.filter((candidate) => candidate === reason).length;
-    degradationMessage = (reasons) => {
-      const malformedAttachments = countReason(reasons, "malformed_attachment");
-      const malformedTitles = countReason(reasons, "missing_or_malformed_title");
-      const invalidColors = countReason(reasons, "invalid_color");
-      return `Issue label summaries omitted or partially projected malformed Huly metadata: ${malformedAttachments} malformed attachment(s), ${malformedTitles} missing or malformed title(s), and ${invalidColors} invalid color(s). Duplicate case-insensitive titles prefer a reference with a valid color.`;
-    };
-    labelsForIssue = (index2, issueId) => index2.byIssueId.get(IssueId.make(issueId)) ?? [];
-    issueIdsMatchingLabel = (index2, label) => {
-      const normalizedFilter = normalizeLabelTitle(label);
-      return [...index2.byIssueId].filter(([, labels]) => labels.some((summary) => normalizeLabelTitle(summary.title) === normalizedFilter)).map(([issueId]) => toIssueRef(issueId)).sort(compareStrings);
-    };
-    loadIssueLabelIndex = (client, space, issueIds) => Effect_exports.gen(function* () {
-      if (issueIds !== void 0 && issueIds.length === 0) return buildIssueLabelIndex([]);
-      const diagnostics = yield* Diagnostics;
-      const baseQuery = {
-        space,
-        attachedToClass: tracker.class.Issue,
-        collection: "labels"
-      };
-      const query = issueIds === void 0 ? baseQuery : { ...baseQuery, attachedTo: { $in: issueIds.map(toDocRef2) } };
-      const attachments = yield* client.findAll(tags.class.TagReference, hulyQuery(query));
-      const index2 = buildIssueLabelIndex(attachments);
-      if (index2.degradationReasons.length > 0) {
-        yield* diagnostics.warnAgent({
-          code: IssueLabelMetadataDegradedWarningCode,
-          message: degradationMessage(index2.degradationReasons)
-        });
+      const taskTypesByProjectTypeList = yield* client.findAll(
+        task.class.TaskType,
+        hulyQuery({ _id: { $in: [...workflowProjectType.tasks] } })
+      );
+      const taskTypesByParent = yield* client.findAll(
+        task.class.TaskType,
+        hulyQuery({ parent: workflowProjectType._id })
+      );
+      const taskTypes = mergeTaskTypes2([...taskTypesByProjectTypeList], [...taskTypesByParent]);
+      const matches = [...taskTypes].filter((candidate) => taskTypeMatches(candidate, taskTypeRef));
+      const selectedTaskType = matches.length === 1 ? matches[0] : void 0;
+      if (selectedTaskType === void 0) {
+        const reason = matches.length === 0 ? "was not found" : "matched more than one task type";
+        return yield* Effect_exports.fail(
+          new HulyError({
+            message: `Task type '${taskTypeRef}' ${reason} in project '${projectIdentifier}' workflow. ${describeTaskTypeOptions([...taskTypes])} ${TASK_TYPE_DISCOVERY_HINT}`
+          })
+        );
       }
-      return index2;
+      const scopedStatuses = selectedTaskType.statuses.flatMap(
+        (statusId) => projectStatuses.filter((status) => status._id === statusId)
+      );
+      const defaultStatusId = selectedTaskType.statuses.includes(project.defaultIssueStatus) ? project.defaultIssueStatus : selectedTaskType.statuses.at(0);
+      return { defaultStatusId, statuses: scopedStatuses, taskType: selectedTaskType };
     });
+    validStatusNames = (workflow) => workflow.statuses.length === 0 ? workflow.taskType.statuses.join(", ") : workflow.statuses.map((status) => status.name).join(", ");
+    resolveStatusForTaskType = (workflow, statusName, projectIdentifier) => {
+      const normalizedStatusName = normalizeForComparison(statusName);
+      const match9 = workflow.statuses.find((status) => normalizeForComparison(status.name) === normalizedStatusName);
+      const statusNames = validStatusNames(workflow);
+      return match9 !== void 0 ? Effect_exports.succeed(match9._id) : Effect_exports.fail(
+        new HulyError({
+          message: `Status '${statusName}' is not valid for task type '${workflow.taskType.name}' in project '${projectIdentifier}'. Valid statuses for this task type: ${statusNames}. ${TASK_TYPE_DISCOVERY_HINT}`
+        })
+      );
+    };
+    chooseStatusForTaskType = (workflow, requestedStatus, currentStatus, projectIdentifier) => {
+      if (requestedStatus !== void 0) {
+        return resolveStatusForTaskType(workflow, requestedStatus, projectIdentifier);
+      }
+      if (currentStatus !== void 0 && workflow.taskType.statuses.includes(currentStatus)) {
+        return Effect_exports.succeed(currentStatus);
+      }
+      return workflow.defaultStatusId !== void 0 ? Effect_exports.succeed(workflow.defaultStatusId) : Effect_exports.fail(
+        new HulyError({
+          message: `Task type '${workflow.taskType.name}' in project '${projectIdentifier}' has no valid status. ${TASK_TYPE_DISCOVERY_HINT}`
+        })
+      );
+    };
   }
 });
 
-// src/huly/operations/issue-milestones-read.ts
-var parseMilestoneRef, uniqueMilestoneRefs, milestoneForIssue, loadIssueMilestoneIndex;
-var init_issue_milestones_read = __esm({
-  "src/huly/operations/issue-milestones-read.ts"() {
+// src/huly/operations/issues-write.ts
+var import_core87, import_rank5, import_tracker3, TxIncResult2, extractUpdatedSequence, requireUpdatedSequence, resolveCreateIssueTaskType, resolveCreateIssueStatus, resolveCreateIssueAssignee, renderCreateIssueDescription, resolveCreateIssueParent, uploadCreateIssueDescription, createIssueWithAssignee, createIssue, createIssueWithResolvedAssignee, deleteIssue;
+var init_issues_write = __esm({
+  "src/huly/operations/issues-write.ts"() {
     "use strict";
+    import_core87 = __toESM(require_lib6(), 1);
+    import_rank5 = __toESM(require_lib24(), 1);
+    import_tracker3 = __toESM(require_lib25(), 1);
     init_dist();
     init_issues();
     init_shared();
-    init_tool_warnings();
-    init_diagnostics();
+    init_errors4();
     init_huly_plugins();
+    init_issue_native_references();
+    init_issues_parent();
+    init_issues_shared();
+    init_issues_write_shared();
     init_query_helpers();
-    parseMilestoneRef = Schema_exports.decodeUnknownOption(IssueMilestoneRefSchema);
-    uniqueMilestoneRefs = (issues) => [
-      ...new Set(
-        issues.flatMap((issue2) => issue2.milestone === null || issue2.milestone === void 0 ? [] : [issue2.milestone])
-      )
-    ];
-    milestoneForIssue = (index2, issue2) => issue2.milestone === null || issue2.milestone === void 0 ? void 0 : index2.get(MilestoneId.make(issue2.milestone));
-    loadIssueMilestoneIndex = (client, project, issues) => Effect_exports.gen(function* () {
-      const refs = uniqueMilestoneRefs(issues);
-      if (refs.length === 0) return /* @__PURE__ */ new Map();
-      const milestones = yield* client.findAll(
-        tracker.class.Milestone,
-        hulyQuery({ space: project._id, _id: { $in: refs } })
-      );
-      const index2 = /* @__PURE__ */ new Map();
-      for (const milestone of milestones) {
+    init_sdk_boundary();
+    TxIncResult2 = Schema_exports.Struct({ object: Schema_exports.Struct({ sequence: Schema_exports.Number }) });
+    extractUpdatedSequence = (txResult) => {
+      const decoded = Schema_exports.decodeUnknownOption(TxIncResult2)(txResult);
+      return decoded._tag === "Some" ? decoded.value.object.sequence : void 0;
+    };
+    requireUpdatedSequence = (txResult, projectIdentifier) => {
+      const sequence = extractUpdatedSequence(txResult);
+      return sequence === void 0 ? Effect_exports.fail(
+        new HulyError({
+          message: `Project '${projectIdentifier}' sequence increment did not return the updated sequence; issue creation stopped to avoid a duplicate identifier.`
+        })
+      ) : Effect_exports.succeed(sequence);
+    };
+    resolveCreateIssueTaskType = (client, project, workflow, params2) => params2.taskType === void 0 ? Effect_exports.succeed(void 0) : resolveTaskTypeWorkflow(client, project, workflow.projectType, workflow.statuses, params2.taskType, params2.project);
+    resolveCreateIssueStatus = (workflow, taskTypeWorkflow, params2) => {
+      if (taskTypeWorkflow !== void 0) {
+        return chooseStatusForTaskType(taskTypeWorkflow, params2.status, void 0, params2.project);
+      }
+      if (params2.status !== void 0) return resolveStatusByName(workflow.statuses, params2.status, params2.project);
+      if (workflow.defaultStatusId !== void 0) return Effect_exports.succeed(workflow.defaultStatusId);
+      return Effect_exports.fail(new InvalidStatusError({ status: "(default)", project: params2.project }));
+    };
+    resolveCreateIssueAssignee = (client, params2) => params2.assignee === void 0 ? Effect_exports.succeed(null) : Effect_exports.map(resolveAssignee(client, params2.assignee), (person) => person._id);
+    renderCreateIssueDescription = (params2) => params2.description !== void 0 && params2.description.trim() !== "" ? renderIssueDescriptionForWrite(params2.description) : Effect_exports.succeed(void 0);
+    resolveCreateIssueParent = (client, project, parentIssue) => parentIssue === void 0 ? Effect_exports.succeed(topLevelIssueParent()) : Effect_exports.map(findIssueInProject(client, project, parentIssue), (parent) => childIssueParent(parent, project._id));
+    uploadCreateIssueDescription = (client, issueId, renderedDescription) => renderedDescription === void 0 ? Effect_exports.succeed(null) : client.uploadMarkup(
+      tracker.class.Issue,
+      issueId,
+      "description",
+      renderedDescription.markup,
+      renderedDescription.format
+    );
+    createIssueWithAssignee = Effect_exports.fn("Issues.createWithAssignee")(function* (params2, assigneeResolution) {
+      const { client, defaultStatusId, project, projectType, statuses } = yield* findProjectWithStatuses(params2.project);
+      const issueId = (0, import_core87.generateId)();
+      const workflow = { projectType, statuses, defaultStatusId };
+      const taskTypeWorkflow = yield* resolveCreateIssueTaskType(client, project, workflow, params2);
+      const statusRef = yield* resolveCreateIssueStatus(workflow, taskTypeWorkflow, params2);
+      const assigneeRef = yield* assigneeResolution(client, params2);
+      const renderedDescription = yield* renderCreateIssueDescription(params2);
+      const { attachedTo, attachedToClass, collection, parents } = yield* resolveCreateIssueParent(
+        client,
+        project,
+        params2.parentIssue
+      );
+      const incOps = { $inc: { sequence: 1 } };
+      const incResult = yield* client.updateDoc(
+        tracker.class.Project,
+        toRef("core:space:Space"),
+        project._id,
+        incOps,
+        true
+      );
+      const sequence = yield* requireUpdatedSequence(incResult, params2.project);
+      const lastIssue = yield* client.findOne(
+        tracker.class.Issue,
+        hulyQuery({ space: project._id }),
+        { sort: { rank: import_core87.SortingOrder.Descending } }
+      );
+      const rank = (0, import_rank5.makeRank)(lastIssue?.rank, void 0);
+      const descriptionMarkupRef = yield* uploadCreateIssueDescription(client, issueId, renderedDescription);
+      const priority = stringToPriority(params2.priority ?? DEFAULT_ISSUE_PRIORITY);
+      const identifier2 = `${project.identifier}-${sequence}`;
+      const issueData = {
+        title: params2.title,
+        description: descriptionMarkupRef,
+        status: statusRef,
+        number: sequence,
+        kind: taskTypeWorkflow?.taskType._id ?? tracker.taskTypes.Issue,
+        identifier: identifier2,
+        priority,
+        assignee: assigneeRef,
+        component: null,
+        estimation: params2.estimation ?? 0,
+        remainingTime: 0,
+        reportedTime: 0,
+        reports: 0,
+        subIssues: 0,
+        parents,
+        childInfo: [],
+        dueDate: params2.dueDate ?? null,
+        rank
+      };
+      yield* client.addCollection(
+        tracker.class.Issue,
+        project._id,
+        attachedTo,
+        attachedToClass,
+        collection,
+        issueData,
+        issueId
+      );
+      return { identifier: IssueIdentifier.make(identifier2), issueId: IssueId.make(issueId) };
+    });
+    createIssue = (params2) => createIssueWithAssignee(params2, resolveCreateIssueAssignee);
+    createIssueWithResolvedAssignee = (params2) => createIssueWithAssignee(params2, () => Effect_exports.succeed(params2.resolvedAssignee));
+    deleteIssue = (params2) => Effect_exports.gen(function* () {
+      const { client, issue: issue2, project } = yield* findProjectAndIssue(params2);
+      yield* client.removeDoc(tracker.class.Issue, project._id, issue2._id);
+      return { identifier: IssueIdentifier.make(issue2.identifier), deleted: true };
+    });
+  }
+});
+
+// src/huly/operations/issue-templates.ts
+var import_core88, NOT_FOUND_INDEX2, findTemplateByIdOrTitle, findProjectAndTemplate, resolveTemplateReferenceLabels, templateChildProjection, resolveChild, buildTemplateChild, listIssueTemplates, getIssueTemplate, createIssueTemplate, resolveIssueFromTemplateAssignee, templateChildCreateParams, templateChildUpdate, createTemplateChildIssues, createIssueFromTemplate, updateIssueTemplate, deleteIssueTemplate, addTemplateChild, removeTemplateChild;
+var init_issue_templates2 = __esm({
+  "src/huly/operations/issue-templates.ts"() {
+    "use strict";
+    import_core88 = __toESM(require_lib6(), 1);
+    init_dist();
+    init_issue_templates();
+    init_issues();
+    init_shared();
+    init_time();
+    init_assertions();
+    init_errors4();
+    init_clear_field_updates();
+    init_components2();
+    init_contacts_shared();
+    init_issues_parent();
+    init_issues_shared();
+    init_issues_write();
+    init_query_helpers();
+    init_sdk_boundary();
+    init_update_guards();
+    init_huly_plugins();
+    init_markup();
+    NOT_FOUND_INDEX2 = -1;
+    findTemplateByIdOrTitle = (client, projectId, templateIdOrTitle) => Effect_exports.gen(function* () {
+      const template = (yield* client.findOne(tracker.class.IssueTemplate, {
+        space: projectId,
+        _id: toRef(templateIdOrTitle)
+      })) ?? (yield* client.findOne(tracker.class.IssueTemplate, {
+        space: projectId,
+        title: templateIdOrTitle
+      }));
+      return template;
+    });
+    findProjectAndTemplate = (params2) => Effect_exports.gen(function* () {
+      const { client, project } = yield* findProject(params2.project);
+      const template = yield* findTemplateByIdOrTitle(client, project._id, params2.template);
+      if (template === void 0) {
+        return yield* new IssueTemplateNotFoundError({ identifier: params2.template, project: params2.project });
+      }
+      return { client, project, template };
+    });
+    resolveTemplateReferenceLabels = (client, assignee, component) => Effect_exports.gen(function* () {
+      const assigneeName = assignee === null ? void 0 : (yield* client.findOne(contact.class.Person, hulyQuery({ _id: assignee })))?.name;
+      const componentLabel = component === null ? void 0 : (yield* client.findOne(tracker.class.Component, hulyQuery({ _id: component })))?.label;
+      return {
+        ...assigneeName === void 0 ? {} : { assigneeName },
+        ...componentLabel === void 0 ? {} : { componentLabel }
+      };
+    });
+    templateChildProjection = (child, description, labels) => {
+      const rawEstimation = zeroAsUnset(NonNegativeNumber.make(child.estimation));
+      const estimation = rawEstimation === void 0 ? void 0 : PositiveTimeHours.make(rawEstimation);
+      return {
+        id: IssueTemplateChildId.make(child.id),
+        title: child.title,
+        priority: priorityToString(child.priority),
+        ...description === void 0 ? {} : { description },
+        ...labels.assigneeName === void 0 ? {} : { assignee: PersonName.make(labels.assigneeName) },
+        ...labels.componentLabel === void 0 ? {} : { component: ComponentLabel.make(labels.componentLabel) },
+        ...estimation === void 0 ? {} : { estimation }
+      };
+    };
+    resolveChild = (client, markupUrlConfig, child) => Effect_exports.gen(function* () {
+      const labels = yield* resolveTemplateReferenceLabels(client, child.assignee, child.component);
+      const description = child.description ? yield* optionalMarkupToMarkdown(child.description, markupUrlConfig, "", {
+        operation: "getIssueTemplate",
+        entity: "issue template child description"
+      }) : void 0;
+      return templateChildProjection(child, description, labels);
+    });
+    buildTemplateChild = (client, markupUrlConfig, projectId, projectIdentifier, input) => Effect_exports.gen(function* () {
+      const assigneeParam = input.assignee;
+      const assigneeRef = assigneeParam !== void 0 ? yield* Effect_exports.gen(function* () {
+        const person = yield* findPersonByEmailOrName(client, assigneeParam);
+        if (person === void 0) {
+          return yield* new PersonNotFoundError({ identifier: assigneeParam });
+        }
+        return person._id;
+      }) : null;
+      const componentParam = input.component;
+      const componentRef = componentParam !== void 0 ? yield* Effect_exports.gen(function* () {
+        const component = yield* findComponentByIdOrLabel(client, projectId, componentParam);
+        if (component === void 0) {
+          return yield* new ComponentNotFoundError({ identifier: componentParam, project: projectIdentifier });
+        }
+        return component._id;
+      }) : null;
+      return {
+        id: (0, import_core88.generateId)(),
+        title: input.title,
+        description: optionalMarkdownToMarkup(input.description, markupUrlConfig, ""),
+        priority: stringToPriority(input.priority ?? DEFAULT_ISSUE_PRIORITY),
+        assignee: assigneeRef,
+        component: componentRef,
+        estimation: input.estimation ?? 0
+      };
+    });
+    listIssueTemplates = (params2) => Effect_exports.gen(function* () {
+      const { client, project } = yield* findProject(params2.project);
+      const limit = clampLimit(params2.limit);
+      const templates2 = yield* client.findAll(
+        tracker.class.IssueTemplate,
+        { space: project._id },
+        { limit, sort: { modifiedOn: import_core88.SortingOrder.Descending } }
+      );
+      const summaries = templates2.map((t) => {
+        const base2 = {
+          id: IssueTemplateId.make(t._id),
+          title: t.title,
+          priority: priorityToString(t.priority),
+          modifiedOn: Timestamp.make(t.modifiedOn)
+        };
+        if (t.children.length > 0) {
+          return { ...base2, childrenCount: Count.make(t.children.length) };
+        }
+        return base2;
+      });
+      return summaries;
+    });
+    getIssueTemplate = (params2) => Effect_exports.gen(function* () {
+      const { client, template } = yield* findProjectAndTemplate(params2);
+      const markupUrlConfig = client.markupUrlConfig;
+      const labels = yield* resolveTemplateReferenceLabels(client, template.assignee, template.component);
+      const description = yield* optionalMarkupToMarkdown(template.description, markupUrlConfig, "", {
+        operation: "getIssueTemplate",
+        entity: "issue template description"
+      });
+      const resolvedChildren = [];
+      for (const child of template.children) {
+        resolvedChildren.push(yield* resolveChild(client, markupUrlConfig, child));
+      }
+      const result3 = {
+        id: IssueTemplateId.make(template._id),
+        title: template.title,
+        description,
+        priority: priorityToString(template.priority),
+        assignee: labels.assigneeName !== void 0 ? PersonName.make(labels.assigneeName) : void 0,
+        component: labels.componentLabel !== void 0 ? ComponentLabel.make(labels.componentLabel) : void 0,
+        estimation: template.estimation > 0 ? PositiveTimeHours.make(template.estimation) : void 0,
+        project: params2.project,
+        modifiedOn: Timestamp.make(template.modifiedOn),
+        createdOn: template.createdOn === void 0 ? void 0 : Timestamp.make(template.createdOn)
+      };
+      if (resolvedChildren.length > 0) {
+        return { ...result3, children: resolvedChildren };
+      }
+      return result3;
+    });
+    createIssueTemplate = (params2) => Effect_exports.gen(function* () {
+      const { client, project } = yield* findProject(params2.project);
+      const markupUrlConfig = client.markupUrlConfig;
+      const templateId = (0, import_core88.generateId)();
+      const assigneeParam = params2.assignee;
+      const assigneeRef = assigneeParam !== void 0 ? yield* Effect_exports.gen(function* () {
+        const person = yield* findPersonByEmailOrName(client, assigneeParam);
+        if (person === void 0) {
+          return yield* new PersonNotFoundError({ identifier: assigneeParam });
+        }
+        return person._id;
+      }) : null;
+      const componentParam = params2.component;
+      const componentRef = componentParam !== void 0 ? yield* Effect_exports.gen(function* () {
+        const component = yield* findComponentByIdOrLabel(client, project._id, componentParam);
+        if (component === void 0) {
+          return yield* new ComponentNotFoundError({ identifier: componentParam, project: params2.project });
+        }
+        return component._id;
+      }) : null;
+      const priority = stringToPriority(params2.priority ?? DEFAULT_ISSUE_PRIORITY);
+      const children = [];
+      if (params2.children !== void 0) {
+        for (const childInput of params2.children) {
+          children.push(yield* buildTemplateChild(client, markupUrlConfig, project._id, params2.project, childInput));
+        }
+      }
+      const templateData = {
+        title: params2.title,
+        description: optionalMarkdownToMarkup(params2.description, markupUrlConfig, ""),
+        priority,
+        assignee: assigneeRef,
+        component: componentRef,
+        estimation: params2.estimation ?? 0,
+        children,
+        comments: 0
+      };
+      yield* client.createDoc(tracker.class.IssueTemplate, project._id, templateData, templateId);
+      return { id: IssueTemplateId.make(templateId), title: params2.title };
+    });
+    resolveIssueFromTemplateAssignee = (client, params2, template) => Effect_exports.gen(function* () {
+      if (params2.assignee === void 0) {
+        if (template.assignee === null) return null;
+        const templatePerson = yield* client.findOne(
+          contact.class.Person,
+          hulyQuery({ _id: template.assignee })
+        );
+        return templatePerson?._id ?? null;
+      }
+      const person = yield* findPersonByEmailOrName(client, params2.assignee);
+      if (person === void 0) return yield* new PersonNotFoundError({ identifier: params2.assignee });
+      return person._id;
+    });
+    templateChildCreateParams = (params2, child, markupUrlConfig) => optionalMarkupToMarkdown(child.description, markupUrlConfig, void 0, {
+      operation: "createIssueFromTemplate",
+      entity: "issue template child description"
+    }).pipe(
+      Effect_exports.map(
+        (description) => ({
+          project: params2.project,
+          title: child.title,
+          priority: priorityToString(child.priority),
+          resolvedAssignee: null,
+          ...description === void 0 ? {} : { description }
+        })
+      )
+    );
+    templateChildUpdate = (child) => ({
+      ...child.assignee === null ? {} : { assignee: child.assignee },
+      ...child.component === null ? {} : { component: child.component },
+      ...child.estimation > 0 ? { estimation: child.estimation } : {}
+    });
+    createTemplateChildIssues = (client, project, template, params2, parentResult, title, markupUrlConfig) => Effect_exports.gen(function* () {
+      const parentIssue = {
+        _id: toRef(parentResult.issueId),
+        identifier: parentResult.identifier,
+        title,
+        parents: []
+      };
+      for (const child of template.children) {
+        const childParams = yield* templateChildCreateParams(params2, child, markupUrlConfig);
+        const childResult = yield* createIssueWithResolvedAssignee(childParams);
+        yield* attachIssueChild(
+          client,
+          project._id,
+          toRef(childResult.issueId),
+          parentIssue,
+          templateChildUpdate(child)
+        );
+      }
+    });
+    createIssueFromTemplate = (params2) => Effect_exports.gen(function* () {
+      const { client, project, template } = yield* findProjectAndTemplate(params2);
+      const markupUrlConfig = client.markupUrlConfig;
+      const title = params2.title ?? template.title;
+      const description = params2.description ?? (yield* optionalMarkupToMarkdown(template.description, markupUrlConfig, void 0, {
+        operation: "createIssueFromTemplate",
+        entity: "issue template description"
+      }));
+      const priority = params2.priority ?? priorityToString(template.priority);
+      const assignee = yield* resolveIssueFromTemplateAssignee(client, params2, template);
+      const issueParams = {
+        project: params2.project,
+        title,
+        description,
+        priority,
+        resolvedAssignee: assignee,
+        status: params2.status
+      };
+      const result3 = yield* createIssueWithResolvedAssignee(issueParams);
+      if (template.component !== null) {
+        yield* client.updateDoc(tracker.class.Issue, project._id, toRef(result3.issueId), {
+          component: template.component
+        });
+      }
+      const includeChildren = params2.includeChildren ?? DEFAULT_INCLUDE_TEMPLATE_CHILDREN;
+      if (includeChildren && template.children.length > 0) {
+        yield* createTemplateChildIssues(client, project, template, params2, result3, title, markupUrlConfig);
+        return { ...result3, childrenCreated: Count.make(template.children.length) };
+      }
+      return result3;
+    });
+    updateIssueTemplate = (params2) => Effect_exports.gen(function* () {
+      yield* requireUpdateFields("update_issue_template", params2, UPDATE_ISSUE_TEMPLATE_FIELDS);
+      const { client, project, template } = yield* findProjectAndTemplate(params2);
+      const markupUrlConfig = client.markupUrlConfig;
+      const updateEntries = {
+        title: Effect_exports.succeed(params2.title === void 0 ? {} : { title: params2.title }),
+        description: Effect_exports.succeed(
+          params2.description === void 0 ? {} : { description: optionalMarkdownToMarkup(clearTextAsEmptyString(params2.description), markupUrlConfig, "") }
+        ),
+        priority: Effect_exports.succeed(params2.priority === void 0 ? {} : { priority: stringToPriority(params2.priority) }),
+        assignee: Effect_exports.gen(function* () {
+          if (params2.assignee === void 0) return {};
+          if (params2.assignee === null) return { assignee: null };
+          const person = yield* findPersonByEmailOrName(client, params2.assignee);
+          if (person === void 0) {
+            return yield* new PersonNotFoundError({ identifier: params2.assignee });
+          }
+          return { assignee: person._id };
+        }),
+        component: Effect_exports.gen(function* () {
+          if (params2.component === void 0) return {};
+          if (params2.component === null) return { component: null };
+          const component = yield* findComponentByIdOrLabel(client, project._id, params2.component);
+          if (component === void 0) {
+            return yield* new ComponentNotFoundError({ identifier: params2.component, project: params2.project });
+          }
+          return { component: component._id };
+        }),
+        estimation: Effect_exports.succeed(
+          params2.estimation === void 0 ? {} : { estimation: params2.estimation === null ? 0 : params2.estimation }
+        )
+      };
+      const updateOps = mergeUpdateEntries(
+        yield* Effect_exports.all(Object.values(updateEntries))
+      );
+      yield* client.updateDoc(tracker.class.IssueTemplate, project._id, template._id, updateOps);
+      return { id: IssueTemplateId.make(template._id), updated: true };
+    });
+    deleteIssueTemplate = (params2) => Effect_exports.gen(function* () {
+      const { client, project, template } = yield* findProjectAndTemplate(params2);
+      yield* client.removeDoc(tracker.class.IssueTemplate, project._id, template._id);
+      return { id: IssueTemplateId.make(template._id), deleted: true };
+    });
+    addTemplateChild = (params2) => Effect_exports.gen(function* () {
+      const { client, project, template } = yield* findProjectAndTemplate(params2);
+      const markupUrlConfig = client.markupUrlConfig;
+      const child = yield* buildTemplateChild(client, markupUrlConfig, project._id, params2.project, {
+        title: params2.title,
+        description: params2.description,
+        priority: params2.priority,
+        assignee: params2.assignee,
+        component: params2.component,
+        estimation: params2.estimation
+      });
+      const newChildren = [...template.children, child];
+      yield* client.updateDoc(tracker.class.IssueTemplate, project._id, template._id, { children: newChildren });
+      return { id: IssueTemplateChildId.make(child.id), title: child.title, added: true };
+    });
+    removeTemplateChild = (params2) => Effect_exports.gen(function* () {
+      const { client, project, template } = yield* findProjectAndTemplate(params2);
+      const childIndex = template.children.findIndex((c) => String(c.id) === String(params2.childId));
+      if (childIndex === NOT_FOUND_INDEX2) {
+        return yield* new TemplateChildNotFoundError({
+          childId: params2.childId,
+          template: params2.template,
+          project: params2.project
+        });
+      }
+      const removedChild = assertAt(template.children, childIndex);
+      const newChildren = template.children.filter((_, i) => i !== childIndex);
+      yield* client.updateDoc(tracker.class.IssueTemplate, project._id, template._id, { children: newChildren });
+      return { id: IssueTemplateChildId.make(removedChild.id), title: removedChild.title, removed: true };
+    });
+  }
+});
+
+// src/huly/operations/issues-move.ts
+var import_core89, import_tracker4, issueTargetClass, addLabel, moveIssue, updateDescendantParents;
+var init_issues_move = __esm({
+  "src/huly/operations/issues-move.ts"() {
+    "use strict";
+    import_core89 = __toESM(require_lib6(), 1);
+    import_tracker4 = __toESM(require_lib25(), 1);
+    init_dist();
+    init_shared();
+    init_tags();
+    init_huly_plugins();
+    init_issues_parent();
+    init_issues_shared();
+    init_query_helpers();
+    init_sdk_boundary();
+    init_tags_shared();
+    issueTargetClass = TagTargetClass.make(String(tracker.class.Issue));
+    addLabel = (params2) => Effect_exports.gen(function* () {
+      const { issue: issue2, project } = yield* findProjectAndIssue(params2);
+      const labelTitle = TagIdentifier.make(params2.label.trim());
+      const tag2 = yield* ensureTagElement({
+        targetClass: issueTargetClass,
+        titleOrId: labelTitle,
+        color: params2.color,
+        fallbackCategory: tracker.category.Other
+      });
+      const result3 = yield* attachTagReference({
+        tag: tag2,
+        objectId: issue2._id,
+        objectClass: tracker.class.Issue,
+        space: project._id,
+        collection: "labels",
+        matchTitleCaseInsensitive: true
+      });
+      return { identifier: IssueIdentifier.make(issue2.identifier), labelAdded: result3.attached };
+    });
+    moveIssue = (params2) => Effect_exports.gen(function* () {
+      const { client, issue: issue2, project } = yield* findProjectAndIssue(params2);
+      const oldParentIsIssue = hasConcreteIssueParent(issue2);
+      const newParentParam = params2.newParent;
+      const target = newParentParam !== null ? yield* Effect_exports.gen(function* () {
+        const parentIssue = yield* findIssueInProject(client, project, newParentParam);
+        return {
+          _tag: "Child",
+          identifier: IssueIdentifier.make(parentIssue.identifier),
+          issue: parentIssue,
+          parent: childIssueParent(parentIssue, project._id)
+        };
+      }) : { _tag: "TopLevel", parent: topLevelIssueParent() };
+      if (target._tag === "Child") {
+        yield* attachIssueChild(client, project._id, issue2._id, target.issue, {});
+      } else {
+        yield* client.updateDoc(tracker.class.Issue, project._id, issue2._id, {
+          attachedTo: toRef(target.parent.attachedTo),
+          attachedToClass: target.parent.attachedToClass,
+          collection: target.parent.collection,
+          parents: target.parent.parents
+        });
+      }
+      if (oldParentIsIssue) {
+        yield* client.updateDoc(
+          tracker.class.Issue,
+          project._id,
+          // issue.attachedTo is Ref<Doc>; for sub-issues it points to the parent issue.
+          // Cast needed because updateDoc expects Ref<HulyIssue> but attachedTo is Ref<Doc>.
+          toRef(issue2.attachedTo),
+          { $inc: { subIssues: -1 } }
+        );
+      }
+      if (issue2.subIssues > 0) {
+        yield* updateDescendantParents(client, project._id, issue2, target.parent.parents);
+      }
+      const result3 = { identifier: IssueIdentifier.make(issue2.identifier), moved: true };
+      if (target._tag === "Child") {
+        return { ...result3, newParent: target.identifier };
+      }
+      return result3;
+    });
+    updateDescendantParents = (client, spaceId, parentIssue, parentNewParents) => Effect_exports.gen(function* () {
+      const thisParentInfo = {
+        parentId: parentIssue._id,
+        identifier: parentIssue.identifier,
+        parentTitle: parentIssue.title,
+        space: spaceId
+      };
+      const children = yield* client.findAll(
+        tracker.class.Issue,
+        hulyQuery({ attachedTo: parentIssue._id, space: spaceId })
+      );
+      for (const child of children) {
+        const childNewParents = [...parentNewParents, thisParentInfo];
+        yield* client.updateDoc(tracker.class.Issue, spaceId, child._id, { parents: childNewParents });
+        if (child.subIssues > 0) {
+          yield* updateDescendantParents(client, spaceId, child, childNewParents);
+        }
+      }
+    });
+  }
+});
+
+// src/huly/operations/issue-creators-read.ts
+var parsePersonRef, uniqueCreatorIds, creatorRef, creatorForIssue, loadIssueCreatorIndex;
+var init_issue_creators_read = __esm({
+  "src/huly/operations/issue-creators-read.ts"() {
+    "use strict";
+    init_dist();
+    init_issues();
+    init_tool_warnings();
+    init_diagnostics();
+    init_huly_plugins();
+    init_contacts_shared();
+    init_query_helpers();
+    init_sdk_boundary();
+    parsePersonRef = Schema_exports.decodeUnknownOption(PersonRefSchema);
+    uniqueCreatorIds = (issues) => [
+      ...new Set(issues.flatMap((issue2) => issue2.createdBy === void 0 ? [] : [issue2.createdBy]))
+    ];
+    creatorRef = (person, emailByPerson) => parsePersonRef({
+      id: person._id,
+      ...person.name.trim() === "" ? {} : { name: person.name },
+      ...emailByPerson.has(person._id) ? { email: emailByPerson.get(person._id) } : {}
+    });
+    creatorForIssue = (index2, issue2) => issue2.createdBy === void 0 ? void 0 : index2.get(issue2.createdBy);
+    loadIssueCreatorIndex = (client, issues) => Effect_exports.gen(function* () {
+      const creatorIds = uniqueCreatorIds(issues);
+      if (creatorIds.length === 0) return /* @__PURE__ */ new Map();
+      const identities = yield* client.findAll(
+        contact.class.SocialIdentity,
+        hulyQuery({ _id: { $in: creatorIds.map(toSocialIdentityRef) } })
+      );
+      const personIds = [...new Set(identities.map((identity2) => identity2.attachedTo))];
+      const persons = personIds.length === 0 ? [] : yield* client.findAll(
+        contact.class.Person,
+        hulyQuery({ _id: { $in: personIds.map(toRef) } })
+      );
+      const emailByPerson = yield* batchGetEmailsForPersons(
+        client,
+        persons.map((person) => person._id)
+      );
+      const personById = new Map(persons.map((person) => [person._id, person]));
+      const index2 = /* @__PURE__ */ new Map();
+      for (const identity2 of identities) {
+        const person = personById.get(identity2.attachedTo);
+        if (person === void 0) continue;
+        const parsed = creatorRef(person, emailByPerson);
+        if (Option_exports.isSome(parsed)) index2.set(identity2._id, parsed.value);
+      }
+      const unresolvedCount = creatorIds.filter((creatorId) => !index2.has(creatorId)).length;
+      if (unresolvedCount > 0) {
+        const diagnostics = yield* Diagnostics;
+        yield* diagnostics.warnAgent({
+          code: IssueCreatorMetadataDegradedWarningCode,
+          message: `${unresolvedCount} unresolved issue creator reference(s) were omitted from issue results.`
+        });
+      }
+      return index2;
+    });
+  }
+});
+
+// src/huly/operations/issue-labels-read.ts
+var IssueLabelAttachmentBoundarySchema, NormalizedLabelTitle, decodeAttachment, decodeTitle, decodeColor, toDocRef2, toIssueRef, normalizeLabelTitle, COLOR_SORT_WIDTH, compareStrings, candidateSortKey, compareCandidates, toCandidate3, projectionCandidate, projectionDegradationReason, projectCandidateGroup, buildIssueLabelIndex, countReason, degradationMessage, labelsForIssue, issueIdsMatchingLabel, loadIssueLabelIndex;
+var init_issue_labels_read = __esm({
+  "src/huly/operations/issue-labels-read.ts"() {
+    "use strict";
+    init_dist();
+    init_shared();
+    init_tool_warnings();
+    init_diagnostics();
+    init_huly_plugins();
+    init_query_helpers();
+    init_sdk_boundary();
+    IssueLabelAttachmentBoundarySchema = Schema_exports.Struct({
+      _id: TagReferenceId,
+      attachedTo: IssueId,
+      title: Schema_exports.optional(Schema_exports.Unknown),
+      color: Schema_exports.optional(Schema_exports.Unknown)
+    }).annotate({
+      title: "IssueLabelAttachmentBoundary",
+      description: "Partial Huly TagReference fields used to project issue labels. Missing or malformed presentation fields are handled by stable projection rules."
+    });
+    NormalizedLabelTitle = NonEmptyString2.pipe(Schema_exports.brand("NormalizedLabelTitle"));
+    decodeAttachment = Schema_exports.decodeUnknownResult(IssueLabelAttachmentBoundarySchema);
+    decodeTitle = Schema_exports.decodeUnknownResult(NonEmptyString2);
+    decodeColor = Schema_exports.decodeUnknownResult(ColorCode);
+    toDocRef2 = (id2) => toRef(IssueId.make(id2));
+    toIssueRef = toRef;
+    normalizeLabelTitle = (title) => NormalizedLabelTitle.make(title.toLowerCase());
+    COLOR_SORT_WIDTH = 2;
+    compareStrings = (left, right) => Number(left > right) - Number(left < right);
+    candidateSortKey = (candidate) => [
+      candidate.normalizedTitle,
+      candidate.color === void 0 ? "1" : "0",
+      candidate.title,
+      String(candidate.color).padStart(COLOR_SORT_WIDTH, "0"),
+      candidate.referenceId
+    ].join("\0");
+    compareCandidates = (left, right) => compareStrings(candidateSortKey(left), candidateSortKey(right));
+    toCandidate3 = (input) => {
+      const attachment2 = decodeAttachment(input);
+      if (Result_exports.isFailure(attachment2)) {
+        return { _tag: "Rejected", degradationReason: "malformed_attachment" };
+      }
+      const title = decodeTitle(attachment2.success.title);
+      if (Result_exports.isFailure(title)) {
+        return { _tag: "Rejected", degradationReason: "missing_or_malformed_title" };
+      }
+      const colorInput = attachment2.success.color;
+      const color = colorInput === void 0 ? void 0 : decodeColor(colorInput);
+      const candidate = {
+        referenceId: attachment2.success._id,
+        issueId: attachment2.success.attachedTo,
+        title: title.success,
+        normalizedTitle: normalizeLabelTitle(title.success),
+        ...color !== void 0 && Result_exports.isSuccess(color) ? { color: color.success } : {}
+      };
+      return color !== void 0 && Result_exports.isFailure(color) ? { _tag: "DegradedSuccess", candidate, degradationReason: "invalid_color" } : { _tag: "Success", candidate };
+    };
+    projectionCandidate = (projection) => projection._tag === "Rejected" ? [] : [projection.candidate];
+    projectionDegradationReason = (projection) => {
+      switch (projection._tag) {
+        case "Success":
+          return [];
+        case "DegradedSuccess":
+        case "Rejected":
+          return [projection.degradationReason];
+      }
+    };
+    projectCandidateGroup = (candidates) => {
+      const sorted = [...candidates].sort(compareCandidates);
+      return sorted.filter(
+        (candidate, index2) => sorted.findIndex((other) => other.normalizedTitle === candidate.normalizedTitle) === index2
+      ).map((candidate) => ({
+        title: candidate.title,
+        ...candidate.color === void 0 ? {} : { color: candidate.color }
+      }));
+    };
+    buildIssueLabelIndex = (attachments) => {
+      const projections = attachments.map(toCandidate3);
+      const candidates = projections.flatMap(projectionCandidate);
+      const issueIds = [...new Set(candidates.map((candidate) => candidate.issueId))];
+      return {
+        byIssueId: new Map(
+          issueIds.map((issueId) => [
+            issueId,
+            projectCandidateGroup(candidates.filter((candidate) => candidate.issueId === issueId))
+          ])
+        ),
+        degradationReasons: projections.flatMap(projectionDegradationReason)
+      };
+    };
+    countReason = (reasons, reason) => reasons.filter((candidate) => candidate === reason).length;
+    degradationMessage = (reasons) => {
+      const malformedAttachments = countReason(reasons, "malformed_attachment");
+      const malformedTitles = countReason(reasons, "missing_or_malformed_title");
+      const invalidColors = countReason(reasons, "invalid_color");
+      return `Issue label summaries omitted or partially projected malformed Huly metadata: ${malformedAttachments} malformed attachment(s), ${malformedTitles} missing or malformed title(s), and ${invalidColors} invalid color(s). Duplicate case-insensitive titles prefer a reference with a valid color.`;
+    };
+    labelsForIssue = (index2, issueId) => index2.byIssueId.get(IssueId.make(issueId)) ?? [];
+    issueIdsMatchingLabel = (index2, label) => {
+      const normalizedFilter = normalizeLabelTitle(label);
+      return [...index2.byIssueId].filter(([, labels]) => labels.some((summary) => normalizeLabelTitle(summary.title) === normalizedFilter)).map(([issueId]) => toIssueRef(issueId)).sort(compareStrings);
+    };
+    loadIssueLabelIndex = (client, space, issueIds) => Effect_exports.gen(function* () {
+      if (issueIds !== void 0 && issueIds.length === 0) return buildIssueLabelIndex([]);
+      const diagnostics = yield* Diagnostics;
+      const baseQuery = {
+        space,
+        attachedToClass: tracker.class.Issue,
+        collection: "labels"
+      };
+      const query = issueIds === void 0 ? baseQuery : { ...baseQuery, attachedTo: { $in: issueIds.map(toDocRef2) } };
+      const attachments = yield* client.findAll(tags.class.TagReference, hulyQuery(query));
+      const index2 = buildIssueLabelIndex(attachments);
+      if (index2.degradationReasons.length > 0) {
+        yield* diagnostics.warnAgent({
+          code: IssueLabelMetadataDegradedWarningCode,
+          message: degradationMessage(index2.degradationReasons)
+        });
+      }
+      return index2;
+    });
+  }
+});
+
+// src/huly/operations/issue-milestones-read.ts
+var parseMilestoneRef, uniqueMilestoneRefs, milestoneForIssue, loadIssueMilestoneIndex;
+var init_issue_milestones_read = __esm({
+  "src/huly/operations/issue-milestones-read.ts"() {
+    "use strict";
+    init_dist();
+    init_issues();
+    init_shared();
+    init_tool_warnings();
+    init_diagnostics();
+    init_huly_plugins();
+    init_query_helpers();
+    parseMilestoneRef = Schema_exports.decodeUnknownOption(IssueMilestoneRefSchema);
+    uniqueMilestoneRefs = (issues) => [
+      ...new Set(
+        issues.flatMap((issue2) => issue2.milestone === null || issue2.milestone === void 0 ? [] : [issue2.milestone])
+      )
+    ];
+    milestoneForIssue = (index2, issue2) => issue2.milestone === null || issue2.milestone === void 0 ? void 0 : index2.get(MilestoneId.make(issue2.milestone));
+    loadIssueMilestoneIndex = (client, project, issues) => Effect_exports.gen(function* () {
+      const refs = uniqueMilestoneRefs(issues);
+      if (refs.length === 0) return /* @__PURE__ */ new Map();
+      const milestones = yield* client.findAll(
+        tracker.class.Milestone,
+        hulyQuery({ space: project._id, _id: { $in: refs } })
+      );
+      const index2 = /* @__PURE__ */ new Map();
+      for (const milestone of milestones) {
         const parsed = parseMilestoneRef({ id: milestone._id, label: milestone.label });
         if (Option_exports.isSome(parsed)) index2.set(parsed.value.id, parsed.value);
       }
@@ -200251,12 +200954,12 @@ var init_milestone_resolution = __esm({
 });
 
 // src/huly/operations/issues-read.ts
-var import_core88, import_tracker4, resolveStatusName, hasUnknownStatusCategory, requireKnownStatusCategories, statusIdsByCategory, applyStatusAndAssigneeFilters, applyCreatorFilter, applyIssueTextFilters, applyIssuePresenceFilters, applyIssueScopeFilters, applyIssueMilestoneFilter, applyIssueQueryFilters, issueSummaryProjection, findIssueForRead, loadIssueAssignee, loadIssueDescription, issueDetailRelationshipFields, issueDetailMetricFields, issueDetailProjection, listIssues, getIssue;
+var import_core90, import_tracker5, resolveStatusName, hasUnknownStatusCategory, requireKnownStatusCategories, statusIdsByCategory, applyStatusAndAssigneeFilters, applyCreatorFilter, applyIssueTextFilters, applyIssuePresenceFilters, applyIssueScopeFilters, applyIssueMilestoneFilter, applyIssueQueryFilters, issueSummaryProjection, findIssueForRead, loadIssueAssignee, loadIssueDescription, issueDetailRelationshipFields, issueDetailMetricFields, issueDetailProjection, listIssues, getIssue;
 var init_issues_read = __esm({
   "src/huly/operations/issues-read.ts"() {
     "use strict";
-    import_core88 = __toESM(require_lib6(), 1);
-    import_tracker4 = __toESM(require_lib25(), 1);
+    import_core90 = __toESM(require_lib6(), 1);
+    import_tracker5 = __toESM(require_lib25(), 1);
     init_dist();
     init_issues();
     init_shared();
@@ -200264,6 +200967,7 @@ var init_issues_read = __esm({
     init_huly_plugins();
     init_components2();
     init_contacts_shared();
+    init_issue_assignee_resolution();
     init_issue_creators_read();
     init_issue_labels_read();
     init_issue_milestones_read();
@@ -200294,9 +200998,9 @@ var init_issues_read = __esm({
         query.status = yield* resolveStatusByName([...statuses], params2.status, params2.project);
       }
       if (params2.assignee !== void 0) {
-        const assigneePerson = yield* findPersonByEmailOrName(client, params2.assignee);
-        if (assigneePerson === void 0) return false;
-        query.assignee = assigneePerson._id;
+        const assigneePerson = yield* findIssueAssignee(client, params2.assignee);
+        if (Option_exports.isNone(assigneePerson)) return false;
+        query.assignee = assigneePerson.value._id;
       }
       return true;
     });
@@ -200436,164 +201140,55 @@ var init_issues_read = __esm({
         tracker.class.Issue,
         hulyQuery(effectiveQuery),
         withLookup(
-          { limit, sort: { modifiedOn: import_core88.SortingOrder.Descending } },
+          { limit, sort: { modifiedOn: import_core90.SortingOrder.Descending } },
           { assignee: contact.class.Person }
         )
       );
       const labelIndex = labelFilterContext === void 0 ? yield* loadIssueLabelIndex(
         client,
-        project._id,
-        issues.map((issue2) => issue2._id)
-      ) : labelFilterContext.index;
-      const milestoneIndex = yield* loadIssueMilestoneIndex(client, project, issues);
-      const creatorIndex = yield* loadIssueCreatorIndex(client, issues);
-      const rawSummaries = issues.map(
-        (issue2) => issueSummaryProjection(issue2, statuses, labelIndex, milestoneIndex, creatorIndex)
-      );
-      const parseIssueSummaries = Schema_exports.decodeUnknownEffect(Schema_exports.Array(IssueSummarySchema));
-      const validated = yield* parseIssueSummaries(rawSummaries).pipe(
-        Effect_exports.mapError(
-          (parseError) => new HulyDataInvalidError({ operation: "listIssues", entity: "issue", cause: parseError })
-        )
-      );
-      return [...validated];
-    });
-    getIssue = (params2) => Effect_exports.gen(function* () {
-      const { client, project, statuses } = yield* findProjectWithStatuses(params2.project);
-      const issue2 = yield* findIssueForRead(client, project, params2);
-      const statusName = resolveStatusName(statuses, issue2.status);
-      const person = yield* loadIssueAssignee(client, issue2);
-      const description = yield* loadIssueDescription(client, issue2);
-      const labelIndex = yield* loadIssueLabelIndex(client, project._id, [issue2._id]);
-      const milestoneIndex = yield* loadIssueMilestoneIndex(client, project, [issue2]);
-      const creatorIndex = yield* loadIssueCreatorIndex(client, [issue2]);
-      const milestone = milestoneForIssue(milestoneIndex, issue2);
-      const creator = creatorForIssue(creatorIndex, issue2);
-      const projected = issueDetailProjection(
-        issue2,
-        params2,
-        statusName,
-        person,
-        description,
-        labelsForIssue(labelIndex, issue2._id),
-        milestone,
-        creator
-      );
-      return yield* parseIssue(projected).pipe(
-        Effect_exports.mapError(
-          (parseError) => new HulyDataInvalidError({ operation: "getIssue", entity: "issue", cause: parseError })
-        )
-      );
-    });
-  }
-});
-
-// src/huly/operations/issue-native-references.ts
-var renderIssueDescriptionForWrite;
-var init_issue_native_references = __esm({
-  "src/huly/operations/issue-native-references.ts"() {
-    "use strict";
-    init_dist();
-    init_client();
-    init_errors4();
-    init_native_reference_markup();
-    renderIssueDescriptionForWrite = (description) => Effect_exports.gen(function* () {
-      const client = yield* HulyClient;
-      const rendered = renderMarkdownWithNativeReferencesForWrite(description, client.markupUrlConfig, "description");
-      if (rendered._tag === "malformed") {
-        return yield* new IssueReferenceError({ reason: rendered.reason });
-      }
-      return rendered.rendered;
-    });
-  }
-});
-
-// src/huly/operations/issues-write-shared.ts
-var resolveAssignee, TASK_TYPE_DISCOVERY_HINT, taskTypeMatches, describeTaskTypeOptions, mergeTaskTypes2, resolveTaskTypeWorkflow, validStatusNames, resolveStatusForTaskType, chooseStatusForTaskType;
-var init_issues_write_shared = __esm({
-  "src/huly/operations/issues-write-shared.ts"() {
-    "use strict";
-    init_dist();
-    init_normalize();
-    init_errors4();
-    init_huly_plugins();
-    init_contacts_shared();
-    init_query_helpers();
-    resolveAssignee = (client, assigneeIdentifier) => Effect_exports.gen(function* () {
-      const person = yield* findPersonByEmailOrName(client, assigneeIdentifier);
-      if (person === void 0) {
-        return yield* new PersonNotFoundError({ identifier: assigneeIdentifier });
-      }
-      return person;
-    });
-    TASK_TYPE_DISCOVERY_HINT = "Use list_task_types or get_project_type to discover valid task types and statuses.";
-    taskTypeMatches = (taskType, taskTypeRef) => String(taskType._id) === String(taskTypeRef) || normalizeForComparison(taskType.name) === normalizeForComparison(taskTypeRef);
-    describeTaskTypeOptions = (taskTypes) => taskTypes.length === 0 ? "No task types are configured for this project type." : `Available task types: ${taskTypes.map((taskType) => `${taskType.name} (${taskType._id})`).join(", ")}.`;
-    mergeTaskTypes2 = (first, second) => {
-      const taskTypesById = /* @__PURE__ */ new Map();
-      for (const taskType of [...first, ...second]) {
-        taskTypesById.set(String(taskType._id), taskType);
-      }
-      return [...taskTypesById.values()];
-    };
-    resolveTaskTypeWorkflow = (client, project, projectType, projectStatuses, taskTypeRef, projectIdentifier) => Effect_exports.gen(function* () {
-      const workflowProjectType = projectType ?? (yield* client.findOne(task.class.ProjectType, hulyQuery({ _id: project.type })));
-      if (workflowProjectType === void 0) {
-        return yield* Effect_exports.fail(
-          new HulyError({
-            message: `Project '${projectIdentifier}' does not expose a project type/workflow, so taskType cannot be resolved. ${TASK_TYPE_DISCOVERY_HINT}`
-          })
-        );
-      }
-      const taskTypesByProjectTypeList = yield* client.findAll(
-        task.class.TaskType,
-        hulyQuery({ _id: { $in: [...workflowProjectType.tasks] } })
-      );
-      const taskTypesByParent = yield* client.findAll(
-        task.class.TaskType,
-        hulyQuery({ parent: workflowProjectType._id })
-      );
-      const taskTypes = mergeTaskTypes2([...taskTypesByProjectTypeList], [...taskTypesByParent]);
-      const matches = [...taskTypes].filter((candidate) => taskTypeMatches(candidate, taskTypeRef));
-      const selectedTaskType = matches.length === 1 ? matches[0] : void 0;
-      if (selectedTaskType === void 0) {
-        const reason = matches.length === 0 ? "was not found" : "matched more than one task type";
-        return yield* Effect_exports.fail(
-          new HulyError({
-            message: `Task type '${taskTypeRef}' ${reason} in project '${projectIdentifier}' workflow. ${describeTaskTypeOptions([...taskTypes])} ${TASK_TYPE_DISCOVERY_HINT}`
-          })
-        );
-      }
-      const scopedStatuses = selectedTaskType.statuses.flatMap(
-        (statusId) => projectStatuses.filter((status) => status._id === statusId)
+        project._id,
+        issues.map((issue2) => issue2._id)
+      ) : labelFilterContext.index;
+      const milestoneIndex = yield* loadIssueMilestoneIndex(client, project, issues);
+      const creatorIndex = yield* loadIssueCreatorIndex(client, issues);
+      const rawSummaries = issues.map(
+        (issue2) => issueSummaryProjection(issue2, statuses, labelIndex, milestoneIndex, creatorIndex)
       );
-      const defaultStatusId = selectedTaskType.statuses.includes(project.defaultIssueStatus) ? project.defaultIssueStatus : selectedTaskType.statuses.at(0);
-      return { defaultStatusId, statuses: scopedStatuses, taskType: selectedTaskType };
+      const parseIssueSummaries = Schema_exports.decodeUnknownEffect(Schema_exports.Array(IssueSummarySchema));
+      const validated = yield* parseIssueSummaries(rawSummaries).pipe(
+        Effect_exports.mapError(
+          (parseError) => new HulyDataInvalidError({ operation: "listIssues", entity: "issue", cause: parseError })
+        )
+      );
+      return [...validated];
     });
-    validStatusNames = (workflow) => workflow.statuses.length === 0 ? workflow.taskType.statuses.join(", ") : workflow.statuses.map((status) => status.name).join(", ");
-    resolveStatusForTaskType = (workflow, statusName, projectIdentifier) => {
-      const normalizedStatusName = normalizeForComparison(statusName);
-      const match9 = workflow.statuses.find((status) => normalizeForComparison(status.name) === normalizedStatusName);
-      const statusNames = validStatusNames(workflow);
-      return match9 !== void 0 ? Effect_exports.succeed(match9._id) : Effect_exports.fail(
-        new HulyError({
-          message: `Status '${statusName}' is not valid for task type '${workflow.taskType.name}' in project '${projectIdentifier}'. Valid statuses for this task type: ${statusNames}. ${TASK_TYPE_DISCOVERY_HINT}`
-        })
+    getIssue = (params2) => Effect_exports.gen(function* () {
+      const { client, project, statuses } = yield* findProjectWithStatuses(params2.project);
+      const issue2 = yield* findIssueForRead(client, project, params2);
+      const statusName = resolveStatusName(statuses, issue2.status);
+      const person = yield* loadIssueAssignee(client, issue2);
+      const description = yield* loadIssueDescription(client, issue2);
+      const labelIndex = yield* loadIssueLabelIndex(client, project._id, [issue2._id]);
+      const milestoneIndex = yield* loadIssueMilestoneIndex(client, project, [issue2]);
+      const creatorIndex = yield* loadIssueCreatorIndex(client, [issue2]);
+      const milestone = milestoneForIssue(milestoneIndex, issue2);
+      const creator = creatorForIssue(creatorIndex, issue2);
+      const projected = issueDetailProjection(
+        issue2,
+        params2,
+        statusName,
+        person,
+        description,
+        labelsForIssue(labelIndex, issue2._id),
+        milestone,
+        creator
       );
-    };
-    chooseStatusForTaskType = (workflow, requestedStatus, currentStatus, projectIdentifier) => {
-      if (requestedStatus !== void 0) {
-        return resolveStatusForTaskType(workflow, requestedStatus, projectIdentifier);
-      }
-      if (currentStatus !== void 0 && workflow.taskType.statuses.includes(currentStatus)) {
-        return Effect_exports.succeed(currentStatus);
-      }
-      return workflow.defaultStatusId !== void 0 ? Effect_exports.succeed(workflow.defaultStatusId) : Effect_exports.fail(
-        new HulyError({
-          message: `Task type '${workflow.taskType.name}' in project '${projectIdentifier}' has no valid status. ${TASK_TYPE_DISCOVERY_HINT}`
-        })
+      return yield* parseIssue(projected).pipe(
+        Effect_exports.mapError(
+          (parseError) => new HulyDataInvalidError({ operation: "getIssue", entity: "issue", cause: parseError })
+        )
       );
-    };
+    });
   }
 });
 
@@ -200698,127 +201293,6 @@ var init_issues_update = __esm({
   }
 });
 
-// src/huly/operations/issues-write.ts
-var import_core89, import_rank5, import_tracker5, TxIncResult2, extractUpdatedSequence, requireUpdatedSequence, resolveCreateIssueTaskType, resolveCreateIssueStatus, resolveCreateIssueAssignee, renderCreateIssueDescription, resolveCreateIssueParent, uploadCreateIssueDescription, createIssue, deleteIssue;
-var init_issues_write = __esm({
-  "src/huly/operations/issues-write.ts"() {
-    "use strict";
-    import_core89 = __toESM(require_lib6(), 1);
-    import_rank5 = __toESM(require_lib24(), 1);
-    import_tracker5 = __toESM(require_lib25(), 1);
-    init_dist();
-    init_issues();
-    init_shared();
-    init_errors4();
-    init_huly_plugins();
-    init_issue_native_references();
-    init_issues_parent();
-    init_issues_shared();
-    init_issues_write_shared();
-    init_query_helpers();
-    init_sdk_boundary();
-    TxIncResult2 = Schema_exports.Struct({ object: Schema_exports.Struct({ sequence: Schema_exports.Number }) });
-    extractUpdatedSequence = (txResult) => {
-      const decoded = Schema_exports.decodeUnknownOption(TxIncResult2)(txResult);
-      return decoded._tag === "Some" ? decoded.value.object.sequence : void 0;
-    };
-    requireUpdatedSequence = (txResult, projectIdentifier) => {
-      const sequence = extractUpdatedSequence(txResult);
-      return sequence === void 0 ? Effect_exports.fail(
-        new HulyError({
-          message: `Project '${projectIdentifier}' sequence increment did not return the updated sequence; issue creation stopped to avoid a duplicate identifier.`
-        })
-      ) : Effect_exports.succeed(sequence);
-    };
-    resolveCreateIssueTaskType = (client, project, workflow, params2) => params2.taskType === void 0 ? Effect_exports.succeed(void 0) : resolveTaskTypeWorkflow(client, project, workflow.projectType, workflow.statuses, params2.taskType, params2.project);
-    resolveCreateIssueStatus = (workflow, taskTypeWorkflow, params2) => {
-      if (taskTypeWorkflow !== void 0) {
-        return chooseStatusForTaskType(taskTypeWorkflow, params2.status, void 0, params2.project);
-      }
-      if (params2.status !== void 0) return resolveStatusByName(workflow.statuses, params2.status, params2.project);
-      if (workflow.defaultStatusId !== void 0) return Effect_exports.succeed(workflow.defaultStatusId);
-      return Effect_exports.fail(new InvalidStatusError({ status: "(default)", project: params2.project }));
-    };
-    resolveCreateIssueAssignee = (client, params2) => params2.assignee === void 0 ? Effect_exports.succeed(null) : Effect_exports.map(resolveAssignee(client, params2.assignee), (person) => person._id);
-    renderCreateIssueDescription = (params2) => params2.description !== void 0 && params2.description.trim() !== "" ? renderIssueDescriptionForWrite(params2.description) : Effect_exports.succeed(void 0);
-    resolveCreateIssueParent = (client, project, parentIssue) => parentIssue === void 0 ? Effect_exports.succeed(topLevelIssueParent()) : Effect_exports.map(findIssueInProject(client, project, parentIssue), (parent) => childIssueParent(parent, project._id));
-    uploadCreateIssueDescription = (client, issueId, renderedDescription) => renderedDescription === void 0 ? Effect_exports.succeed(null) : client.uploadMarkup(
-      tracker.class.Issue,
-      issueId,
-      "description",
-      renderedDescription.markup,
-      renderedDescription.format
-    );
-    createIssue = (params2) => Effect_exports.gen(function* () {
-      const { client, defaultStatusId, project, projectType, statuses } = yield* findProjectWithStatuses(params2.project);
-      const issueId = (0, import_core89.generateId)();
-      const workflow = { projectType, statuses, defaultStatusId };
-      const taskTypeWorkflow = yield* resolveCreateIssueTaskType(client, project, workflow, params2);
-      const statusRef = yield* resolveCreateIssueStatus(workflow, taskTypeWorkflow, params2);
-      const assigneeRef = yield* resolveCreateIssueAssignee(client, params2);
-      const renderedDescription = yield* renderCreateIssueDescription(params2);
-      const { attachedTo, attachedToClass, collection, parents } = yield* resolveCreateIssueParent(
-        client,
-        project,
-        params2.parentIssue
-      );
-      const incOps = { $inc: { sequence: 1 } };
-      const incResult = yield* client.updateDoc(
-        tracker.class.Project,
-        toRef("core:space:Space"),
-        project._id,
-        incOps,
-        true
-      );
-      const sequence = yield* requireUpdatedSequence(incResult, params2.project);
-      const lastIssue = yield* client.findOne(
-        tracker.class.Issue,
-        hulyQuery({ space: project._id }),
-        { sort: { rank: import_core89.SortingOrder.Descending } }
-      );
-      const rank = (0, import_rank5.makeRank)(lastIssue?.rank, void 0);
-      const descriptionMarkupRef = yield* uploadCreateIssueDescription(client, issueId, renderedDescription);
-      const priority = stringToPriority(params2.priority ?? DEFAULT_ISSUE_PRIORITY);
-      const identifier2 = `${project.identifier}-${sequence}`;
-      const issueData = {
-        title: params2.title,
-        description: descriptionMarkupRef,
-        status: statusRef,
-        number: sequence,
-        kind: taskTypeWorkflow?.taskType._id ?? tracker.taskTypes.Issue,
-        identifier: identifier2,
-        priority,
-        assignee: assigneeRef,
-        component: null,
-        estimation: params2.estimation ?? 0,
-        remainingTime: 0,
-        reportedTime: 0,
-        reports: 0,
-        subIssues: 0,
-        parents,
-        childInfo: [],
-        dueDate: params2.dueDate ?? null,
-        rank
-      };
-      yield* client.addCollection(
-        tracker.class.Issue,
-        project._id,
-        attachedTo,
-        attachedToClass,
-        collection,
-        issueData,
-        issueId
-      );
-      return { identifier: IssueIdentifier.make(identifier2), issueId: IssueId.make(issueId) };
-    });
-    deleteIssue = (params2) => Effect_exports.gen(function* () {
-      const { client, issue: issue2, project } = yield* findProjectAndIssue(params2);
-      yield* client.removeDoc(tracker.class.Issue, project._id, issue2._id);
-      return { identifier: IssueIdentifier.make(issue2.identifier), deleted: true };
-    });
-  }
-});
-
 // src/huly/operations/issues.ts
 var init_issues2 = __esm({
   "src/huly/operations/issues.ts"() {
@@ -200830,351 +201304,6 @@ var init_issues2 = __esm({
   }
 });
 
-// src/huly/operations/issue-templates.ts
-var import_core90, NOT_FOUND_INDEX2, findTemplateByIdOrTitle, findProjectAndTemplate, resolveTemplateReferenceLabels, templateChildProjection, resolveChild, buildTemplateChild, listIssueTemplates, getIssueTemplate, createIssueTemplate, resolveIssueFromTemplateAssignee, templateChildCreateParams, templateChildUpdate, createTemplateChildIssues, createIssueFromTemplate, updateIssueTemplate, deleteIssueTemplate, addTemplateChild, removeTemplateChild;
-var init_issue_templates2 = __esm({
-  "src/huly/operations/issue-templates.ts"() {
-    "use strict";
-    import_core90 = __toESM(require_lib6(), 1);
-    init_dist();
-    init_issue_templates();
-    init_issues();
-    init_shared();
-    init_time();
-    init_assertions();
-    init_errors4();
-    init_clear_field_updates();
-    init_components2();
-    init_contacts_shared();
-    init_issues_parent();
-    init_issues_shared();
-    init_issues2();
-    init_query_helpers();
-    init_sdk_boundary();
-    init_update_guards();
-    init_huly_plugins();
-    init_markup();
-    NOT_FOUND_INDEX2 = -1;
-    findTemplateByIdOrTitle = (client, projectId, templateIdOrTitle) => Effect_exports.gen(function* () {
-      const template = (yield* client.findOne(tracker.class.IssueTemplate, {
-        space: projectId,
-        _id: toRef(templateIdOrTitle)
-      })) ?? (yield* client.findOne(tracker.class.IssueTemplate, {
-        space: projectId,
-        title: templateIdOrTitle
-      }));
-      return template;
-    });
-    findProjectAndTemplate = (params2) => Effect_exports.gen(function* () {
-      const { client, project } = yield* findProject(params2.project);
-      const template = yield* findTemplateByIdOrTitle(client, project._id, params2.template);
-      if (template === void 0) {
-        return yield* new IssueTemplateNotFoundError({ identifier: params2.template, project: params2.project });
-      }
-      return { client, project, template };
-    });
-    resolveTemplateReferenceLabels = (client, assignee, component) => Effect_exports.gen(function* () {
-      const assigneeName = assignee === null ? void 0 : (yield* client.findOne(contact.class.Person, hulyQuery({ _id: assignee })))?.name;
-      const componentLabel = component === null ? void 0 : (yield* client.findOne(tracker.class.Component, hulyQuery({ _id: component })))?.label;
-      return {
-        ...assigneeName === void 0 ? {} : { assigneeName },
-        ...componentLabel === void 0 ? {} : { componentLabel }
-      };
-    });
-    templateChildProjection = (child, description, labels) => {
-      const rawEstimation = zeroAsUnset(NonNegativeNumber.make(child.estimation));
-      const estimation = rawEstimation === void 0 ? void 0 : PositiveTimeHours.make(rawEstimation);
-      return {
-        id: IssueTemplateChildId.make(child.id),
-        title: child.title,
-        priority: priorityToString(child.priority),
-        ...description === void 0 ? {} : { description },
-        ...labels.assigneeName === void 0 ? {} : { assignee: PersonName.make(labels.assigneeName) },
-        ...labels.componentLabel === void 0 ? {} : { component: ComponentLabel.make(labels.componentLabel) },
-        ...estimation === void 0 ? {} : { estimation }
-      };
-    };
-    resolveChild = (client, markupUrlConfig, child) => Effect_exports.gen(function* () {
-      const labels = yield* resolveTemplateReferenceLabels(client, child.assignee, child.component);
-      const description = child.description ? yield* optionalMarkupToMarkdown(child.description, markupUrlConfig, "", {
-        operation: "getIssueTemplate",
-        entity: "issue template child description"
-      }) : void 0;
-      return templateChildProjection(child, description, labels);
-    });
-    buildTemplateChild = (client, markupUrlConfig, projectId, projectIdentifier, input) => Effect_exports.gen(function* () {
-      const assigneeParam = input.assignee;
-      const assigneeRef = assigneeParam !== void 0 ? yield* Effect_exports.gen(function* () {
-        const person = yield* findPersonByEmailOrName(client, assigneeParam);
-        if (person === void 0) {
-          return yield* new PersonNotFoundError({ identifier: assigneeParam });
-        }
-        return person._id;
-      }) : null;
-      const componentParam = input.component;
-      const componentRef = componentParam !== void 0 ? yield* Effect_exports.gen(function* () {
-        const component = yield* findComponentByIdOrLabel(client, projectId, componentParam);
-        if (component === void 0) {
-          return yield* new ComponentNotFoundError({ identifier: componentParam, project: projectIdentifier });
-        }
-        return component._id;
-      }) : null;
-      return {
-        id: (0, import_core90.generateId)(),
-        title: input.title,
-        description: optionalMarkdownToMarkup(input.description, markupUrlConfig, ""),
-        priority: stringToPriority(input.priority ?? DEFAULT_ISSUE_PRIORITY),
-        assignee: assigneeRef,
-        component: componentRef,
-        estimation: input.estimation ?? 0
-      };
-    });
-    listIssueTemplates = (params2) => Effect_exports.gen(function* () {
-      const { client, project } = yield* findProject(params2.project);
-      const limit = clampLimit(params2.limit);
-      const templates2 = yield* client.findAll(
-        tracker.class.IssueTemplate,
-        { space: project._id },
-        { limit, sort: { modifiedOn: import_core90.SortingOrder.Descending } }
-      );
-      const summaries = templates2.map((t) => {
-        const base2 = {
-          id: IssueTemplateId.make(t._id),
-          title: t.title,
-          priority: priorityToString(t.priority),
-          modifiedOn: Timestamp.make(t.modifiedOn)
-        };
-        if (t.children.length > 0) {
-          return { ...base2, childrenCount: Count.make(t.children.length) };
-        }
-        return base2;
-      });
-      return summaries;
-    });
-    getIssueTemplate = (params2) => Effect_exports.gen(function* () {
-      const { client, template } = yield* findProjectAndTemplate(params2);
-      const markupUrlConfig = client.markupUrlConfig;
-      const labels = yield* resolveTemplateReferenceLabels(client, template.assignee, template.component);
-      const description = yield* optionalMarkupToMarkdown(template.description, markupUrlConfig, "", {
-        operation: "getIssueTemplate",
-        entity: "issue template description"
-      });
-      const resolvedChildren = [];
-      for (const child of template.children) {
-        resolvedChildren.push(yield* resolveChild(client, markupUrlConfig, child));
-      }
-      const result3 = {
-        id: IssueTemplateId.make(template._id),
-        title: template.title,
-        description,
-        priority: priorityToString(template.priority),
-        assignee: labels.assigneeName !== void 0 ? PersonName.make(labels.assigneeName) : void 0,
-        component: labels.componentLabel !== void 0 ? ComponentLabel.make(labels.componentLabel) : void 0,
-        estimation: template.estimation > 0 ? PositiveTimeHours.make(template.estimation) : void 0,
-        project: params2.project,
-        modifiedOn: Timestamp.make(template.modifiedOn),
-        createdOn: template.createdOn === void 0 ? void 0 : Timestamp.make(template.createdOn)
-      };
-      if (resolvedChildren.length > 0) {
-        return { ...result3, children: resolvedChildren };
-      }
-      return result3;
-    });
-    createIssueTemplate = (params2) => Effect_exports.gen(function* () {
-      const { client, project } = yield* findProject(params2.project);
-      const markupUrlConfig = client.markupUrlConfig;
-      const templateId = (0, import_core90.generateId)();
-      const assigneeParam = params2.assignee;
-      const assigneeRef = assigneeParam !== void 0 ? yield* Effect_exports.gen(function* () {
-        const person = yield* findPersonByEmailOrName(client, assigneeParam);
-        if (person === void 0) {
-          return yield* new PersonNotFoundError({ identifier: assigneeParam });
-        }
-        return person._id;
-      }) : null;
-      const componentParam = params2.component;
-      const componentRef = componentParam !== void 0 ? yield* Effect_exports.gen(function* () {
-        const component = yield* findComponentByIdOrLabel(client, project._id, componentParam);
-        if (component === void 0) {
-          return yield* new ComponentNotFoundError({ identifier: componentParam, project: params2.project });
-        }
-        return component._id;
-      }) : null;
-      const priority = stringToPriority(params2.priority ?? DEFAULT_ISSUE_PRIORITY);
-      const children = [];
-      if (params2.children !== void 0) {
-        for (const childInput of params2.children) {
-          children.push(yield* buildTemplateChild(client, markupUrlConfig, project._id, params2.project, childInput));
-        }
-      }
-      const templateData = {
-        title: params2.title,
-        description: optionalMarkdownToMarkup(params2.description, markupUrlConfig, ""),
-        priority,
-        assignee: assigneeRef,
-        component: componentRef,
-        estimation: params2.estimation ?? 0,
-        children,
-        comments: 0
-      };
-      yield* client.createDoc(tracker.class.IssueTemplate, project._id, templateData, templateId);
-      return { id: IssueTemplateId.make(templateId), title: params2.title };
-    });
-    resolveIssueFromTemplateAssignee = (client, params2, template) => Effect_exports.gen(function* () {
-      if (params2.assignee !== void 0) return params2.assignee;
-      if (template.assignee === null) return void 0;
-      const person = yield* client.findOne(contact.class.Person, hulyQuery({ _id: template.assignee }));
-      if (person === void 0) return void 0;
-      const emailChannel = yield* client.findOne(
-        contact.class.Channel,
-        hulyQuery({ attachedTo: person._id, provider: contact.channelProvider.Email })
-      );
-      return Email.make(emailChannel?.value ?? person.name);
-    });
-    templateChildCreateParams = (params2, child, markupUrlConfig) => optionalMarkupToMarkdown(child.description, markupUrlConfig, void 0, {
-      operation: "createIssueFromTemplate",
-      entity: "issue template child description"
-    }).pipe(
-      Effect_exports.map(
-        (description) => ({
-          project: params2.project,
-          title: child.title,
-          priority: priorityToString(child.priority),
-          ...description === void 0 ? {} : { description }
-        })
-      )
-    );
-    templateChildUpdate = (child) => ({
-      ...child.assignee === null ? {} : { assignee: child.assignee },
-      ...child.component === null ? {} : { component: child.component },
-      ...child.estimation > 0 ? { estimation: child.estimation } : {}
-    });
-    createTemplateChildIssues = (client, project, template, params2, parentResult, title, markupUrlConfig) => Effect_exports.gen(function* () {
-      const parentIssue = {
-        _id: toRef(parentResult.issueId),
-        identifier: parentResult.identifier,
-        title,
-        parents: []
-      };
-      for (const child of template.children) {
-        const childParams = yield* templateChildCreateParams(params2, child, markupUrlConfig);
-        const childResult = yield* createIssue(childParams);
-        yield* attachIssueChild(
-          client,
-          project._id,
-          toRef(childResult.issueId),
-          parentIssue,
-          templateChildUpdate(child)
-        );
-      }
-    });
-    createIssueFromTemplate = (params2) => Effect_exports.gen(function* () {
-      const { client, project, template } = yield* findProjectAndTemplate(params2);
-      const markupUrlConfig = client.markupUrlConfig;
-      const title = params2.title ?? template.title;
-      const description = params2.description ?? (yield* optionalMarkupToMarkdown(template.description, markupUrlConfig, void 0, {
-        operation: "createIssueFromTemplate",
-        entity: "issue template description"
-      }));
-      const priority = params2.priority ?? priorityToString(template.priority);
-      const assignee = yield* resolveIssueFromTemplateAssignee(client, params2, template);
-      const issueParams = {
-        project: params2.project,
-        title,
-        description,
-        priority,
-        assignee,
-        status: params2.status
-      };
-      const result3 = yield* createIssue(issueParams);
-      if (template.component !== null) {
-        yield* client.updateDoc(tracker.class.Issue, project._id, toRef(result3.issueId), {
-          component: template.component
-        });
-      }
-      const includeChildren = params2.includeChildren ?? DEFAULT_INCLUDE_TEMPLATE_CHILDREN;
-      if (includeChildren && template.children.length > 0) {
-        yield* createTemplateChildIssues(client, project, template, params2, result3, title, markupUrlConfig);
-        return { ...result3, childrenCreated: Count.make(template.children.length) };
-      }
-      return result3;
-    });
-    updateIssueTemplate = (params2) => Effect_exports.gen(function* () {
-      yield* requireUpdateFields("update_issue_template", params2, UPDATE_ISSUE_TEMPLATE_FIELDS);
-      const { client, project, template } = yield* findProjectAndTemplate(params2);
-      const markupUrlConfig = client.markupUrlConfig;
-      const updateEntries = {
-        title: Effect_exports.succeed(params2.title === void 0 ? {} : { title: params2.title }),
-        description: Effect_exports.succeed(
-          params2.description === void 0 ? {} : { description: optionalMarkdownToMarkup(clearTextAsEmptyString(params2.description), markupUrlConfig, "") }
-        ),
-        priority: Effect_exports.succeed(params2.priority === void 0 ? {} : { priority: stringToPriority(params2.priority) }),
-        assignee: Effect_exports.gen(function* () {
-          if (params2.assignee === void 0) return {};
-          if (params2.assignee === null) return { assignee: null };
-          const person = yield* findPersonByEmailOrName(client, params2.assignee);
-          if (person === void 0) {
-            return yield* new PersonNotFoundError({ identifier: params2.assignee });
-          }
-          return { assignee: person._id };
-        }),
-        component: Effect_exports.gen(function* () {
-          if (params2.component === void 0) return {};
-          if (params2.component === null) return { component: null };
-          const component = yield* findComponentByIdOrLabel(client, project._id, params2.component);
-          if (component === void 0) {
-            return yield* new ComponentNotFoundError({ identifier: params2.component, project: params2.project });
-          }
-          return { component: component._id };
-        }),
-        estimation: Effect_exports.succeed(
-          params2.estimation === void 0 ? {} : { estimation: params2.estimation === null ? 0 : params2.estimation }
-        )
-      };
-      const updateOps = mergeUpdateEntries(
-        yield* Effect_exports.all(Object.values(updateEntries))
-      );
-      yield* client.updateDoc(tracker.class.IssueTemplate, project._id, template._id, updateOps);
-      return { id: IssueTemplateId.make(template._id), updated: true };
-    });
-    deleteIssueTemplate = (params2) => Effect_exports.gen(function* () {
-      const { client, project, template } = yield* findProjectAndTemplate(params2);
-      yield* client.removeDoc(tracker.class.IssueTemplate, project._id, template._id);
-      return { id: IssueTemplateId.make(template._id), deleted: true };
-    });
-    addTemplateChild = (params2) => Effect_exports.gen(function* () {
-      const { client, project, template } = yield* findProjectAndTemplate(params2);
-      const markupUrlConfig = client.markupUrlConfig;
-      const child = yield* buildTemplateChild(client, markupUrlConfig, project._id, params2.project, {
-        title: params2.title,
-        description: params2.description,
-        priority: params2.priority,
-        assignee: params2.assignee,
-        component: params2.component,
-        estimation: params2.estimation
-      });
-      const newChildren = [...template.children, child];
-      yield* client.updateDoc(tracker.class.IssueTemplate, project._id, template._id, { children: newChildren });
-      return { id: IssueTemplateChildId.make(child.id), title: child.title, added: true };
-    });
-    removeTemplateChild = (params2) => Effect_exports.gen(function* () {
-      const { client, project, template } = yield* findProjectAndTemplate(params2);
-      const childIndex = template.children.findIndex((c) => String(c.id) === String(params2.childId));
-      if (childIndex === NOT_FOUND_INDEX2) {
-        return yield* new TemplateChildNotFoundError({
-          childId: params2.childId,
-          template: params2.template,
-          project: params2.project
-        });
-      }
-      const removedChild = assertAt(template.children, childIndex);
-      const newChildren = template.children.filter((_, i) => i !== childIndex);
-      yield* client.updateDoc(tracker.class.IssueTemplate, project._id, template._id, { children: newChildren });
-      return { id: IssueTemplateChildId.make(removedChild.id), title: removedChild.title, removed: true };
-    });
-  }
-});
-
 // src/huly/operations/tags.ts
 var import_core91, toTagSummary, buildUpdateTagOperations, listTags, createTag, updateTag, deleteTag, listAttachedTags, attachTag, detachTag;
 var init_tags2 = __esm({
@@ -201464,7 +201593,7 @@ var init_issues3 = __esm({
           name: "list_issues",
           description: `Query Huly issues with optional filters. Returns issues sorted by modification date (newest first). Supports filtering by project, exact workflow status name (status), Huly SDK task.statusCategory key (statusCategory: ${enumValuesDescription(
             StatusCategoryValues
-          )}), assignee, creator (raw Person ID, exact email, or exact display name), component, a human-readable attached label title (label, exact and case-insensitive), milestone (project-scoped ID or exact case-insensitive label), milestone presence (hasMilestone), parentIssue (to list children of a specific issue), and isTopLevel (to return only native top-level issues). Creator, label, and milestone filters are applied before the result limit; ambiguous creator display names fail actionably and unknown creators return an empty list. Each result includes creator as a stable Person reference { id, name?, email? } when resolvable and the assigned milestone as { id, label } when resolvable. Supports searching by title substring (titleSearch) and description content (descriptionSearch). Each result includes deterministic label summaries with title and available color; missing labels are an empty array, duplicate titles collapse case-insensitively while preferring a valid color, and unusable partial attachments are omitted with a tool warning.`,
+          )}), assignee (email, Person display name, or exact agent UserProfile title), creator (raw Person ID, exact email, or exact display name), component, a human-readable attached label title (label, exact and case-insensitive), milestone (project-scoped ID or exact case-insensitive label), milestone presence (hasMilestone), parentIssue (to list children of a specific issue), and isTopLevel (to return only native top-level issues). Creator, label, and milestone filters are applied before the result limit; ambiguous creator display names fail actionably and unknown creators return an empty list. Each result includes creator as a stable Person reference { id, name?, email? } when resolvable and the assigned milestone as { id, label } when resolvable. Supports searching by title substring (titleSearch) and description content (descriptionSearch). Each result includes deterministic label summaries with title and available color; missing labels are an empty array, duplicate titles collapse case-insensitively while preferring a valid color, and unusable partial attachments are omitted with a tool warning.`,
           category: CATEGORY24,
           inputSchema: listIssuesParamsJsonSchema,
           resultSchema: ListIssuesResultSchema
@@ -201486,7 +201615,7 @@ var init_issues3 = __esm({
       defineTool(
         {
           name: "create_issue",
-          description: "Create a new issue in a Huly project. Omit parentIssue for a native top-level issue, or specify parentIssue to create a sub-issue. Optionally set taskType by ID or display name; it is resolved within the target project's project type, and status is validated against that task type's workflow. Use list_task_types or get_project_type to discover valid task types and statuses. Description supports markdown formatting; markdown links to current-workspace Huly browse URLs with _class, _id, and label become native references, while external URLs stay normal links. Returns the created issue identifier.",
+          description: "Create a new issue in a Huly project. Assignee accepts an email, Person display name, or exact agent UserProfile title and always stores the linked Person. Omit parentIssue for a native top-level issue, or specify parentIssue to create a sub-issue. Optionally set taskType by ID or display name; it is resolved within the target project's project type, and status is validated against that task type's workflow. Use list_task_types or get_project_type to discover valid task types and statuses. Description supports markdown formatting; markdown links to current-workspace Huly browse URLs with _class, _id, and label become native references, while external URLs stay normal links. Returns the created issue identifier.",
           category: CATEGORY24,
           inputSchema: createIssueParamsJsonSchema,
           resultSchema: CreateIssueResultSchema
@@ -201497,7 +201626,7 @@ var init_issues3 = __esm({
       defineTool(
         {
           name: "update_issue",
-          description: "Update fields on an existing Huly issue. Optionally set taskType by ID or display name; it is resolved within the target project's project type, and the status is preserved only when valid for the new task type. Use list_task_types or get_project_type to discover valid task types and statuses. Only provided fields are modified. Description updates support markdown; markdown links to current-workspace Huly browse URLs with _class, _id, and label become native references, while external URLs stay normal links.",
+          description: "Update fields on an existing Huly issue. Assignee accepts an email, Person display name, or exact agent UserProfile title and always stores the linked Person; use null to unassign. Optionally set taskType by ID or display name; it is resolved within the target project's project type, and the status is preserved only when valid for the new task type. Use list_task_types or get_project_type to discover valid task types and statuses. Only provided fields are modified. Description updates support markdown; markdown links to current-workspace Huly browse URLs with _class, _id, and label become native references, while external URLs stay normal links.",
           category: CATEGORY24,
           inputSchema: updateIssueParamsJsonSchema,
           resultSchema: UpdateIssueResultSchema
@@ -223136,7 +223265,7 @@ if (unsupportedRuntime) {
     detectedNodeVersion: process.versions.node,
     executable: process.execPath,
     requiredNodeVersion: nodeEngineRequirement,
-    serverVersion: "0.49.6"
+    serverVersion: "0.50.0"
   });
   startUnsupportedNodeMcp(config2);
 } else {