@firfi/huly-mcp 0.1.37 → 0.1.38

package/README.md

@@ -167,6 +167,9 @@ MCP_TRANSPORT=http MCP_HTTP_PORT=8080 MCP_HTTP_HOST=0.0.0.0 npx -y @firfi/huly-m
 | `create_issue_from_template` | Create a new issue from a template. Applies template defaults, allowing overrides for specific fields. Returns the created issue identifier. |
 | `update_issue_template` | Update fields on an existing Huly issue template. Only provided fields are modified. |
 | `delete_issue_template` | Permanently delete a Huly issue template. This action cannot be undone. |
+| `add_issue_relation` | Add a relation between two issues. Relation types: 'blocks' (source blocks target — pushes into target's blockedBy), 'is-blocked-by' (source is blocked by target — pushes into source's blockedBy), 'relates-to' (bidirectional link — updates both sides). targetIssue accepts cross-project identifiers like 'OTHER-42'. No-op if the relation already exists. |
+| `remove_issue_relation` | Remove a relation between two issues. Mirrors add_issue_relation: 'blocks' pulls from target's blockedBy, 'is-blocked-by' pulls from source's blockedBy, 'relates-to' pulls from both sides. No-op if the relation doesn't exist. |
+| `list_issue_relations` | List all relations of an issue. Returns blockedBy (issues blocking this one) and relations (bidirectional links) with resolved identifiers. Does NOT return issues that this issue blocks — use list_issue_relations on the target issue to see that. |
 
 ### Comments
 

package/dist/index.cjs

@@ -173663,7 +173663,7 @@ var PostHog = class extends PostHogBackendClient {
 };
 
 // src/version.ts
-var VERSION = true ? "0.1.35" : "0.0.0-dev";
+var VERSION = true ? "0.1.37" : "0.0.0-dev";
 
 // src/telemetry/posthog.ts
 var POSTHOG_API_KEY = "phc_TGfFqCGdnF0p68wuFzd5WSw1IsBvOJW0YgoMJDyZPjm";
@@ -177114,6 +177114,51 @@ var FulltextSearchParamsSchema = Schema_exports.Struct({
 var fulltextSearchParamsJsonSchema = JSONSchema_exports.make(FulltextSearchParamsSchema);
 var parseFulltextSearchParams = Schema_exports.decodeUnknown(FulltextSearchParamsSchema);
 
+// src/domain/schemas/relations.ts
+var RelationTypeValues = ["blocks", "is-blocked-by", "relates-to"];
+var RelationTypeSchema = Schema_exports.Literal(...RelationTypeValues).annotations({
+  title: "RelationType",
+  description: "Type of issue relation: 'blocks' (source blocks target), 'is-blocked-by' (source is blocked by target), 'relates-to' (bidirectional link)",
+  jsonSchema: { type: "string", enum: [...RelationTypeValues] }
+});
+var issueRelationFields = {
+  project: ProjectIdentifier.annotations({
+    description: "Project identifier of the source issue (e.g., 'HULY')"
+  }),
+  issueIdentifier: IssueIdentifier.annotations({
+    description: "Source issue identifier (e.g., 'HULY-123')"
+  }),
+  targetIssue: IssueIdentifier.annotations({
+    description: "Target issue identifier \u2014 same project: '42' or 'PROJ-42'; cross-project: 'OTHER-42'"
+  }),
+  relationType: RelationTypeSchema
+};
+var AddIssueRelationParamsSchema = Schema_exports.Struct(issueRelationFields).annotations({
+  title: "AddIssueRelationParams",
+  description: "Parameters for adding a relation between two issues"
+});
+var RemoveIssueRelationParamsSchema = Schema_exports.Struct(issueRelationFields).annotations({
+  title: "RemoveIssueRelationParams",
+  description: "Parameters for removing a relation between two issues"
+});
+var ListIssueRelationsParamsSchema = Schema_exports.Struct({
+  project: ProjectIdentifier.annotations({
+    description: "Project identifier (e.g., 'HULY')"
+  }),
+  issueIdentifier: IssueIdentifier.annotations({
+    description: "Issue identifier (e.g., 'HULY-123')"
+  })
+}).annotations({
+  title: "ListIssueRelationsParams",
+  description: "Parameters for listing all relations of an issue"
+});
+var addIssueRelationParamsJsonSchema = JSONSchema_exports.make(AddIssueRelationParamsSchema);
+var removeIssueRelationParamsJsonSchema = JSONSchema_exports.make(RemoveIssueRelationParamsSchema);
+var listIssueRelationsParamsJsonSchema = JSONSchema_exports.make(ListIssueRelationsParamsSchema);
+var parseAddIssueRelationParams = Schema_exports.decodeUnknown(AddIssueRelationParamsSchema);
+var parseRemoveIssueRelationParams = Schema_exports.decodeUnknown(RemoveIssueRelationParamsSchema);
+var parseListIssueRelationsParams = Schema_exports.decodeUnknown(ListIssueRelationsParamsSchema);
+
 // src/domain/schemas/notifications.ts
 var ListNotificationsParamsSchema = Schema_exports.Struct({
   limit: Schema_exports.optional(
@@ -179515,6 +179560,165 @@ var deleteIssueTemplate = (params) => Effect_exports.gen(function* () {
   return { id: IssueTemplateId.make(template._id), deleted: true };
 });
 
+// src/huly/operations/relations.ts
+var resolveTargetIssue = (client, sourceProject, targetIssueStr) => Effect_exports.gen(function* () {
+  const { fullIdentifier } = parseIssueIdentifier(targetIssueStr, sourceProject.identifier);
+  const match16 = fullIdentifier.match(/^([A-Z]+)-\d+$/i);
+  const prefix = match16 ? match16[1].toUpperCase() : null;
+  if (prefix !== null && prefix !== sourceProject.identifier.toUpperCase()) {
+    const { client: c, project: targetProject } = yield* findProject(prefix);
+    const issue3 = yield* findIssueInProject(c, targetProject, targetIssueStr);
+    return { issue: issue3, project: targetProject };
+  }
+  const issue2 = yield* findIssueInProject(client, sourceProject, targetIssueStr);
+  return { issue: issue2, project: sourceProject };
+});
+var makeRelatedDoc = (issue2) => ({
+  _id: toRef(issue2._id),
+  _class: toRef(tracker.class.Issue)
+});
+var hasRelation = (arr, targetId) => arr?.some((r) => r._id === toRef(targetId)) ?? false;
+var addIssueRelation = (params) => Effect_exports.gen(function* () {
+  const { client, issue: source, project: project3 } = yield* findProjectAndIssue({
+    project: params.project,
+    identifier: params.issueIdentifier
+  });
+  const { issue: target, project: targetProject } = yield* resolveTargetIssue(
+    client,
+    project3,
+    params.targetIssue
+  );
+  const result = { sourceIssue: source.identifier, targetIssue: target.identifier, relationType: params.relationType };
+  switch (params.relationType) {
+    case "blocks": {
+      if (hasRelation(target.blockedBy, source._id)) {
+        return { ...result, added: false };
+      }
+      yield* client.updateDoc(
+        tracker.class.Issue,
+        targetProject._id,
+        target._id,
+        { $push: { blockedBy: makeRelatedDoc(source) } }
+      );
+      return { ...result, added: true };
+    }
+    case "is-blocked-by": {
+      if (hasRelation(source.blockedBy, target._id)) {
+        return { ...result, added: false };
+      }
+      yield* client.updateDoc(
+        tracker.class.Issue,
+        project3._id,
+        source._id,
+        { $push: { blockedBy: makeRelatedDoc(target) } }
+      );
+      return { ...result, added: true };
+    }
+    case "relates-to": {
+      if (hasRelation(source.relations, target._id)) {
+        return { ...result, added: false };
+      }
+      yield* client.updateDoc(
+        tracker.class.Issue,
+        project3._id,
+        source._id,
+        { $push: { relations: makeRelatedDoc(target) } }
+      );
+      yield* client.updateDoc(
+        tracker.class.Issue,
+        targetProject._id,
+        target._id,
+        { $push: { relations: makeRelatedDoc(source) } }
+      );
+      return { ...result, added: true };
+    }
+  }
+});
+var removeIssueRelation = (params) => Effect_exports.gen(function* () {
+  const { client, issue: source, project: project3 } = yield* findProjectAndIssue({
+    project: params.project,
+    identifier: params.issueIdentifier
+  });
+  const { issue: target, project: targetProject } = yield* resolveTargetIssue(
+    client,
+    project3,
+    params.targetIssue
+  );
+  const result = { sourceIssue: source.identifier, targetIssue: target.identifier, relationType: params.relationType };
+  switch (params.relationType) {
+    case "blocks": {
+      if (!hasRelation(target.blockedBy, source._id)) {
+        return { ...result, removed: false };
+      }
+      yield* client.updateDoc(
+        tracker.class.Issue,
+        targetProject._id,
+        target._id,
+        { $pull: { blockedBy: { _id: toRef(source._id) } } }
+      );
+      return { ...result, removed: true };
+    }
+    case "is-blocked-by": {
+      if (!hasRelation(source.blockedBy, target._id)) {
+        return { ...result, removed: false };
+      }
+      yield* client.updateDoc(
+        tracker.class.Issue,
+        project3._id,
+        source._id,
+        { $pull: { blockedBy: { _id: toRef(target._id) } } }
+      );
+      return { ...result, removed: true };
+    }
+    case "relates-to": {
+      if (!hasRelation(source.relations, target._id)) {
+        return { ...result, removed: false };
+      }
+      yield* client.updateDoc(
+        tracker.class.Issue,
+        project3._id,
+        source._id,
+        { $pull: { relations: { _id: toRef(target._id) } } }
+      );
+      yield* client.updateDoc(
+        tracker.class.Issue,
+        targetProject._id,
+        target._id,
+        { $pull: { relations: { _id: toRef(source._id) } } }
+      );
+      return { ...result, removed: true };
+    }
+  }
+});
+var listIssueRelations = (params) => Effect_exports.gen(function* () {
+  const { client, issue: issue2 } = yield* findProjectAndIssue({
+    project: params.project,
+    identifier: params.issueIdentifier
+  });
+  const blockedByRefs = issue2.blockedBy ?? [];
+  const relationsRefs = issue2.relations ?? [];
+  const allIds = [...blockedByRefs, ...relationsRefs].map((r) => r._id);
+  if (allIds.length === 0) {
+    return { blockedBy: [], relations: [] };
+  }
+  const toIssueRef = toRef;
+  const issueIds = allIds.map(toIssueRef);
+  const issues = yield* client.findAll(
+    tracker.class.Issue,
+    { _id: { $in: issueIds } }
+  );
+  const idToIdentifier = new Map(issues.map((i) => [String(i._id), i.identifier]));
+  const toEntry = (r) => ({
+    identifier: idToIdentifier.get(String(r._id)) ?? String(r._id),
+    _id: String(r._id),
+    _class: String(r._class)
+  });
+  return {
+    blockedBy: blockedByRefs.map(toEntry),
+    relations: relationsRefs.map(toEntry)
+  };
+});
+
 // src/mcp/tools/issues.ts
 var CATEGORY9 = "issues";
 var issueTools = [
@@ -179715,6 +179919,39 @@ var issueTools = [
       parseDeleteIssueTemplateParams,
       deleteIssueTemplate
     )
+  },
+  {
+    name: "add_issue_relation",
+    description: "Add a relation between two issues. Relation types: 'blocks' (source blocks target \u2014 pushes into target's blockedBy), 'is-blocked-by' (source is blocked by target \u2014 pushes into source's blockedBy), 'relates-to' (bidirectional link \u2014 updates both sides). targetIssue accepts cross-project identifiers like 'OTHER-42'. No-op if the relation already exists.",
+    category: CATEGORY9,
+    inputSchema: addIssueRelationParamsJsonSchema,
+    handler: createToolHandler(
+      "add_issue_relation",
+      parseAddIssueRelationParams,
+      addIssueRelation
+    )
+  },
+  {
+    name: "remove_issue_relation",
+    description: "Remove a relation between two issues. Mirrors add_issue_relation: 'blocks' pulls from target's blockedBy, 'is-blocked-by' pulls from source's blockedBy, 'relates-to' pulls from both sides. No-op if the relation doesn't exist.",
+    category: CATEGORY9,
+    inputSchema: removeIssueRelationParamsJsonSchema,
+    handler: createToolHandler(
+      "remove_issue_relation",
+      parseRemoveIssueRelationParams,
+      removeIssueRelation
+    )
+  },
+  {
+    name: "list_issue_relations",
+    description: "List all relations of an issue. Returns blockedBy (issues blocking this one) and relations (bidirectional links) with resolved identifiers. Does NOT return issues that this issue blocks \u2014 use list_issue_relations on the target issue to see that.",
+    category: CATEGORY9,
+    inputSchema: listIssueRelationsParamsJsonSchema,
+    handler: createToolHandler(
+      "list_issue_relations",
+      parseListIssueRelationsParams,
+      listIssueRelations
+    )
   }
 ];