huly-mcp-sdk 0.2.1

package/dist/tools/milestones.js

@@ -0,0 +1,26 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listMilestones = void 0;
+const tracker_1 = __importDefault(require("@hcengineering/tracker"));
+const connection_1 = require("../connection");
+const errors_1 = require("../utils/errors");
+const format_1 = require("../utils/format");
+exports.listMilestones = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)();
+    const project = await client.findOne(tracker_1.default.class.Project, { identifier: args.projectIdentifier });
+    if (project == null)
+        throw new Error(`Project '${args.projectIdentifier}' not found.`);
+    const milestones = await client.findAll(tracker_1.default.class.Milestone, { space: project._id });
+    if (milestones.length === 0)
+        return `No milestones found in project ${args.projectIdentifier}.`;
+    const lines = milestones.map((m) => {
+        const status = format_1.MILESTONE_STATUS_LABELS[m.status] ?? 'Unknown';
+        const target = (0, format_1.formatDate)(m.targetDate);
+        return `- **${m.label}** [${status}] — Target: ${target}`;
+    });
+    return `## Milestones in ${args.projectIdentifier} (${milestones.length})\n\n${lines.join('\n')}`;
+});
+//# sourceMappingURL=milestones.js.map

package/dist/tools/milestones.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"milestones.js","sourceRoot":"","sources":["../../src/tools/milestones.ts"],"names":[],"mappings":";;;;;;AAAA,qEAA4C;AAC5C,8CAA6C;AAC7C,4CAAiD;AACjD,4CAAqE;AAIxD,QAAA,cAAc,GAAG,IAAA,wBAAe,EAAuC,KAAK,EAAE,IAAI,EAAE,EAAE;IACjG,MAAM,MAAM,GAAG,MAAM,IAAA,0BAAa,GAAE,CAAA;IACpC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,iBAAO,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAA;IACnG,IAAI,OAAO,IAAI,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,CAAC,iBAAiB,cAAc,CAAC,CAAA;IAEtF,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,iBAAO,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;IAExF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,kCAAkC,IAAI,CAAC,iBAAiB,GAAG,CAAA;IAE/F,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACjC,MAAM,MAAM,GAAG,gCAAuB,CAAC,CAAC,CAAC,MAAgB,CAAC,IAAI,SAAS,CAAA;QACvE,MAAM,MAAM,GAAG,IAAA,mBAAU,EAAC,CAAC,CAAC,UAAU,CAAC,CAAA;QACvC,OAAO,OAAO,CAAC,CAAC,KAAK,OAAO,MAAM,eAAe,MAAM,EAAE,CAAA;IAC3D,CAAC,CAAC,CAAA;IAEF,OAAO,oBAAoB,IAAI,CAAC,iBAAiB,KAAK,UAAU,CAAC,MAAM,QAAQ,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAA;AACnG,CAAC,CAAC,CAAA"}

package/dist/tools/projects.d.ts

@@ -0,0 +1,14 @@
+export declare const listProjects: (args: Record<string, never>) => Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;
+export declare const getProject: (args: {
+    identifier: string;
+}) => Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;

package/dist/tools/projects.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProject = exports.listProjects = void 0;
+const tracker_1 = __importDefault(require("@hcengineering/tracker"));
+const connection_1 = require("../connection");
+const errors_1 = require("../utils/errors");
+exports.listProjects = (0, errors_1.wrapToolHandler)(async () => {
+    const client = await (0, connection_1.getConnection)();
+    const projects = await client.findAll(tracker_1.default.class.Project, {});
+    if (projects.length === 0)
+        return 'No projects found in this workspace.';
+    const lines = projects.map((p) => `- **${p.identifier}** — ${p.name ?? '(no name)'}${p.description != null && p.description !== '' ? `\n  ${p.description}` : ''}`);
+    return `## Projects (${projects.length})\n\n${lines.join('\n')}`;
+});
+exports.getProject = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)();
+    const project = await client.findOne(tracker_1.default.class.Project, { identifier: args.identifier });
+    if (project == null)
+        throw new Error(`Project '${args.identifier}' not found.`);
+    const statuses = await client.findAll(tracker_1.default.class.IssueStatus, { space: project._id });
+    const statusList = statuses.map((s) => `  - ${s.name}`).join('\n');
+    return [
+        `## Project: ${project.identifier}`,
+        `**Name:** ${project.name ?? '(no name)'}`,
+        project.description != null && project.description !== '' ? `**Description:** ${project.description}` : null,
+        `**Issues created:** ${project.sequence}`,
+        `\n**Statuses:**\n${statusList}`
+    ].filter(Boolean).join('\n');
+});
+//# sourceMappingURL=projects.js.map

package/dist/tools/projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../../src/tools/projects.ts"],"names":[],"mappings":";;;;;;AAAA,qEAA4C;AAC5C,8CAA6C;AAC7C,4CAAiD;AAIpC,QAAA,YAAY,GAAG,IAAA,wBAAe,EAAwB,KAAK,IAAI,EAAE;IAC5E,MAAM,MAAM,GAAG,MAAM,IAAA,0BAAa,GAAE,CAAA;IACpC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,iBAAO,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;IAEhE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,sCAAsC,CAAA;IAExE,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC/B,OAAO,CAAC,CAAC,UAAU,QAAQ,CAAC,CAAC,IAAI,IAAI,WAAW,GAAG,CAAC,CAAC,WAAW,IAAI,IAAI,IAAI,CAAC,CAAC,WAAW,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CACjI,CAAA;IACD,OAAO,gBAAgB,QAAQ,CAAC,MAAM,QAAQ,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAA;AAClE,CAAC,CAAC,CAAA;AAEW,QAAA,UAAU,GAAG,IAAA,wBAAe,EAAmC,KAAK,EAAE,IAAI,EAAE,EAAE;IACzF,MAAM,MAAM,GAAG,MAAM,IAAA,0BAAa,GAAE,CAAA;IACpC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,iBAAO,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAA;IAC5F,IAAI,OAAO,IAAI,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,CAAC,UAAU,cAAc,CAAC,CAAA;IAE/E,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,iBAAO,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;IACxF,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAElE,OAAO;QACL,eAAe,OAAO,CAAC,UAAU,EAAE;QACnC,aAAa,OAAO,CAAC,IAAI,IAAI,WAAW,EAAE;QAC1C,OAAO,CAAC,WAAW,IAAI,IAAI,IAAI,OAAO,CAAC,WAAW,KAAK,EAAE,CAAC,CAAC,CAAC,oBAAoB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;QAC5G,uBAAuB,OAAO,CAAC,QAAQ,EAAE;QACzC,oBAAoB,UAAU,EAAE;KACjC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC9B,CAAC,CAAC,CAAA"}

package/dist/tools/relations.d.ts

@@ -0,0 +1,27 @@
+export declare const addRelation: (args: {
+    identifier: string;
+    relatedTo: string;
+}) => Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;
+export declare const addBlockedBy: (args: {
+    identifier: string;
+    blockedBy: string;
+}) => Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;
+export declare const setParent: (args: {
+    identifier: string;
+    parentIdentifier?: string | null | undefined;
+}) => Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;

package/dist/tools/relations.js

@@ -0,0 +1,103 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setParent = exports.addBlockedBy = exports.addRelation = void 0;
+const tracker_1 = __importDefault(require("@hcengineering/tracker"));
+const connection_1 = require("../connection");
+const errors_1 = require("../utils/errors");
+exports.addRelation = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)();
+    const issueA = await client.findOne(tracker_1.default.class.Issue, { identifier: args.identifier });
+    if (issueA == null)
+        throw new Error(`Issue '${args.identifier}' not found.`);
+    const issueB = await client.findOne(tracker_1.default.class.Issue, { identifier: args.relatedTo });
+    if (issueB == null)
+        throw new Error(`Issue '${args.relatedTo}' not found.`);
+    const relA = { _id: issueB._id, _class: issueB._class };
+    const relB = { _id: issueA._id, _class: issueA._class };
+    const existingRels = issueA.relations ?? [];
+    if (existingRels.some((r) => r._id === issueB._id)) {
+        return `**${args.identifier}** is already related to **${args.relatedTo}**.`;
+    }
+    // Add bidirectional relation
+    await client.updateDoc(tracker_1.default.class.Issue, issueA.space, issueA._id, {
+        relations: [...existingRels, relA]
+    });
+    await client.updateDoc(tracker_1.default.class.Issue, issueB.space, issueB._id, {
+        relations: [...(issueB.relations ?? []), relB]
+    });
+    return `✅ **${args.identifier}** is now related to **${args.relatedTo}**`;
+});
+exports.addBlockedBy = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)();
+    const issue = await client.findOne(tracker_1.default.class.Issue, { identifier: args.identifier });
+    if (issue == null)
+        throw new Error(`Issue '${args.identifier}' not found.`);
+    const blocker = await client.findOne(tracker_1.default.class.Issue, { identifier: args.blockedBy });
+    if (blocker == null)
+        throw new Error(`Issue '${args.blockedBy}' not found.`);
+    const blockerRef = { _id: blocker._id, _class: blocker._class };
+    const existing = issue.blockedBy ?? [];
+    if (existing.some((r) => r._id === blocker._id)) {
+        return `**${args.identifier}** is already blocked by **${args.blockedBy}**.`;
+    }
+    await client.updateDoc(tracker_1.default.class.Issue, issue.space, issue._id, {
+        blockedBy: [...existing, blockerRef]
+    });
+    return `✅ **${args.identifier}** is now blocked by **${args.blockedBy}**`;
+});
+exports.setParent = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)();
+    const child = await client.findOne(tracker_1.default.class.Issue, { identifier: args.identifier });
+    if (child == null)
+        throw new Error(`Issue '${args.identifier}' not found.`);
+    // Clear parent if requested
+    if (args.parentIdentifier == null) {
+        await client.updateDoc(tracker_1.default.class.Issue, child.space, child._id, { parents: [] });
+        // Remove from old parent's childInfo if there was one
+        if (child.parents.length > 0) {
+            const oldParentId = child.parents[0].parentId;
+            const oldParent = await client.findOne(tracker_1.default.class.Issue, { _id: oldParentId });
+            if (oldParent != null) {
+                const newChildInfo = (oldParent.childInfo ?? []).filter((c) => c.childId !== child._id);
+                await client.updateDoc(tracker_1.default.class.Issue, oldParent.space, oldParent._id, {
+                    subIssues: Math.max(0, (oldParent.subIssues ?? 1) - 1),
+                    childInfo: newChildInfo
+                });
+            }
+        }
+        return `✅ Cleared parent from **${args.identifier}**`;
+    }
+    const parent = await client.findOne(tracker_1.default.class.Issue, { identifier: args.parentIdentifier });
+    if (parent == null)
+        throw new Error(`Parent issue '${args.parentIdentifier}' not found.`);
+    if (parent._id === child._id)
+        throw new Error('An issue cannot be its own parent.');
+    const parentInfo = {
+        parentId: parent._id,
+        identifier: parent.identifier,
+        parentTitle: parent.title,
+        space: parent.space
+    };
+    const childInfoEntry = {
+        childId: child._id,
+        estimation: child.estimation ?? 0,
+        reportedTime: child.reportedTime ?? 0
+    };
+    // Update child's parents list
+    await client.updateDoc(tracker_1.default.class.Issue, child.space, child._id, {
+        parents: [parentInfo, ...child.parents]
+    });
+    // Update parent's subIssues count and childInfo
+    const existingChildInfo = parent.childInfo ?? [];
+    if (!existingChildInfo.some((c) => c.childId === child._id)) {
+        await client.updateDoc(tracker_1.default.class.Issue, parent.space, parent._id, {
+            subIssues: (parent.subIssues ?? 0) + 1,
+            childInfo: [...existingChildInfo, childInfoEntry]
+        });
+    }
+    return `✅ **${args.identifier}** is now a sub-issue of **${args.parentIdentifier}**`;
+});
+//# sourceMappingURL=relations.js.map

package/dist/tools/relations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relations.js","sourceRoot":"","sources":["../../src/tools/relations.ts"],"names":[],"mappings":"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"}

package/dist/tools/search.d.ts

@@ -0,0 +1,9 @@
+export declare const searchIssues: (args: {
+    limit: number;
+    query: string;
+}) => Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+}>;

package/dist/tools/search.js

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchIssues = void 0;
+const tracker_1 = __importDefault(require("@hcengineering/tracker"));
+const connection_1 = require("../connection");
+const errors_1 = require("../utils/errors");
+const format_1 = require("../utils/format");
+exports.searchIssues = (0, errors_1.wrapToolHandler)(async (args) => {
+    const client = await (0, connection_1.getConnection)();
+    const result = await client.searchFulltext({ query: args.query, classes: [tracker_1.default.class.Issue] }, { limit: args.limit });
+    if (result.docs.length === 0)
+        return `No issues found for query: "${args.query}"`;
+    // Enrich each result with full issue data
+    const enriched = await Promise.all(result.docs.map(async (r) => {
+        const issue = await client.findOne(tracker_1.default.class.Issue, { _id: r.id });
+        if (issue == null)
+            return null;
+        const status = await client.findOne(tracker_1.default.class.IssueStatus, { _id: issue.status });
+        return { issue, statusName: status?.name ?? 'Unknown' };
+    }));
+    const lines = enriched
+        .filter((e) => e !== null)
+        .map((e) => {
+        const due = e.issue.dueDate != null ? ` | Due: ${(0, format_1.formatDate)(e.issue.dueDate)}` : '';
+        return `- **${e.issue.identifier}** [${e.statusName}] [${(0, format_1.priorityLabel)(e.issue.priority)}]${due}\n  ${e.issue.title}`;
+    });
+    return `## Search results for "${args.query}" (${lines.length})\n\n${lines.join('\n')}`;
+});
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":";;;;;;AAAA,qEAA4C;AAC5C,8CAA6C;AAC7C,4CAAiD;AACjD,4CAA2D;AAI9C,QAAA,YAAY,GAAG,IAAA,wBAAe,EAAqC,KAAK,EAAE,IAAI,EAAE,EAAE;IAC7F,MAAM,MAAM,GAAG,MAAM,IAAA,0BAAa,GAAE,CAAA;IAEpC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,CACxC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,iBAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,EACrD,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CACtB,CAAA;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,+BAA+B,IAAI,CAAC,KAAK,GAAG,CAAA;IAEjF,0CAA0C;IAC1C,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAC1B,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,iBAAO,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,EAAS,EAAE,CAAC,CAAA;QAC7E,IAAI,KAAK,IAAI,IAAI;YAAE,OAAO,IAAI,CAAA;QAC9B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,iBAAO,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;QACrF,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,IAAI,SAAS,EAAE,CAAA;IACzD,CAAC,CAAC,CACH,CAAA;IAED,MAAM,KAAK,GAAG,QAAQ;SACnB,MAAM,CAAC,CAAC,CAAC,EAA8B,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;SACrD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,WAAW,IAAA,mBAAU,EAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QACnF,OAAO,OAAO,CAAC,CAAC,KAAK,CAAC,UAAU,OAAO,CAAC,CAAC,UAAU,MAAM,IAAA,sBAAa,EAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;IACvH,CAAC,CAAC,CAAA;IAEJ,OAAO,0BAA0B,IAAI,CAAC,KAAK,MAAM,KAAK,CAAC,MAAM,QAAQ,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAA;AACzF,CAAC,CAAC,CAAA"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,11 @@
+export declare class HulyMcpError extends Error {
+    constructor(message: string);
+}
+type ToolResult = {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+};
+export declare function wrapToolHandler<T extends Record<string, unknown>>(handler: (args: T) => Promise<string>): (args: T) => Promise<ToolResult>;
+export {};

package/dist/utils/errors.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HulyMcpError = void 0;
+exports.wrapToolHandler = wrapToolHandler;
+class HulyMcpError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'HulyMcpError';
+    }
+}
+exports.HulyMcpError = HulyMcpError;
+function wrapToolHandler(handler) {
+    return async (args) => {
+        try {
+            const text = await handler(args);
+            return { content: [{ type: 'text', text }] };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            throw new Error(`Huly MCP: ${message}`);
+        }
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":";;;AASA,0CAYC;AArBD,MAAa,YAAa,SAAQ,KAAK;IACrC,YAAa,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,cAAc,CAAA;IAC5B,CAAC;CACF;AALD,oCAKC;AAID,SAAgB,eAAe,CAC7B,OAAqC;IAErC,OAAO,KAAK,EAAE,IAAO,EAAuB,EAAE;QAC5C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;YAChC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAA;QAC9C,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YAChE,MAAM,IAAI,KAAK,CAAC,aAAa,OAAO,EAAE,CAAC,CAAA;QACzC,CAAC;IACH,CAAC,CAAA;AACH,CAAC"}

package/dist/utils/format.d.ts

@@ -0,0 +1,4 @@
+export declare const PRIORITY_LABELS: Record<number, string>;
+export declare const MILESTONE_STATUS_LABELS: Record<number, string>;
+export declare function formatDate(ts: number | null | undefined): string;
+export declare function priorityLabel(priority: number): string;

package/dist/utils/format.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MILESTONE_STATUS_LABELS = exports.PRIORITY_LABELS = void 0;
+exports.formatDate = formatDate;
+exports.priorityLabel = priorityLabel;
+const tracker_1 = require("@hcengineering/tracker");
+exports.PRIORITY_LABELS = {
+    [tracker_1.IssuePriority.NoPriority]: 'No Priority',
+    [tracker_1.IssuePriority.Urgent]: 'Urgent',
+    [tracker_1.IssuePriority.High]: 'High',
+    [tracker_1.IssuePriority.Medium]: 'Medium',
+    [tracker_1.IssuePriority.Low]: 'Low'
+};
+exports.MILESTONE_STATUS_LABELS = {
+    0: 'Planned',
+    1: 'In Progress',
+    2: 'Completed',
+    3: 'Canceled'
+};
+function formatDate(ts) {
+    if (ts == null)
+        return 'None';
+    return new Date(ts).toISOString().split('T')[0];
+}
+function priorityLabel(priority) {
+    return exports.PRIORITY_LABELS[priority] ?? 'Unknown';
+}
+//# sourceMappingURL=format.js.map

package/dist/utils/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":";;;AAiBA,gCAGC;AAED,sCAEC;AAxBD,oDAAsD;AAEzC,QAAA,eAAe,GAA2B;IACrD,CAAC,uBAAa,CAAC,UAAU,CAAC,EAAE,aAAa;IACzC,CAAC,uBAAa,CAAC,MAAM,CAAC,EAAE,QAAQ;IAChC,CAAC,uBAAa,CAAC,IAAI,CAAC,EAAE,MAAM;IAC5B,CAAC,uBAAa,CAAC,MAAM,CAAC,EAAE,QAAQ;IAChC,CAAC,uBAAa,CAAC,GAAG,CAAC,EAAE,KAAK;CAC3B,CAAA;AAEY,QAAA,uBAAuB,GAA2B;IAC7D,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,aAAa;IAChB,CAAC,EAAE,WAAW;IACd,CAAC,EAAE,UAAU;CACd,CAAA;AAED,SAAgB,UAAU,CAAE,EAA6B;IACvD,IAAI,EAAE,IAAI,IAAI;QAAE,OAAO,MAAM,CAAA;IAC7B,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;AACjD,CAAC;AAED,SAAgB,aAAa,CAAE,QAAgB;IAC7C,OAAO,uBAAe,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAA;AAC/C,CAAC"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "huly-mcp-sdk",
+  "version": "0.2.1",
+  "description": "MCP server for Huly — connect Claude Desktop to your Huly workspace via the native WebSocket SDK",
+  "keywords": [
+    "huly",
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "project-management",
+    "issue-tracker",
+    "anthropic"
+  ],
+  "homepage": "https://github.com/varaprasadreddy9676/huly-mcp#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/varaprasadreddy9676/huly-mcp.git"
+  },
+  "license": "EPL-2.0",
+  "author": "SaiVaraprasad Medapati",
+  "bin": {
+    "huly-mcp": "dist/index.js",
+    "huly-mcp-setup": "scripts/setup.js"
+  },
+  "files": [
+    "dist/",
+    "scripts/",
+    ".env.example",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "node --max-old-space-size=4096 node_modules/typescript/bin/tsc",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "setup": "node scripts/setup.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@hcengineering/account-client": "^0.7.0",
+    "@hcengineering/chunter": "^0.7.0",
+    "@hcengineering/contact": "^0.7.0",
+    "@hcengineering/core": "^0.7.0",
+    "@hcengineering/document": "^0.7.0",
+    "@hcengineering/platform": "^0.7.0",
+    "@hcengineering/rank": "^0.7.0",
+    "@hcengineering/tags": "^0.7.0",
+    "@hcengineering/server-client": "^0.7.0",
+    "@hcengineering/task": "^0.7.0",
+    "@hcengineering/tracker": "^0.7.0",
+    "@modelcontextprotocol/sdk": "^1.10.0",
+    "ws": "^8.18.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  }
+}

package/scripts/cleanup-issues.js

@@ -0,0 +1,132 @@
+#!/usr/bin/env node
+/**
+ * Delete a range of issues from a Huly project.
+ *
+ * Usage:
+ *   node scripts/cleanup-issues.js <project> <start> <end> [--confirm]
+ *
+ * Example (dry run — shows what would be deleted):
+ *   node scripts/cleanup-issues.js VISIO 59 68
+ *
+ * Example (actually delete):
+ *   node scripts/cleanup-issues.js VISIO 59 68 --confirm
+ *
+ * Auth is read from .env (HULY_TOKEN + HULY_WORKSPACE, or HULY_EMAIL + HULY_PASSWORD).
+ */
+
+'use strict'
+
+const fs = require('fs')
+const path = require('path')
+
+// Load .env
+const envPath = path.join(__dirname, '..', '.env')
+if (fs.existsSync(envPath)) {
+  for (const line of fs.readFileSync(envPath, 'utf8').split('\n')) {
+    const m = line.match(/^([^#=\s]+)\s*=\s*(.*)$/)
+    if (m) process.env[m[1]] = m[2].trim()
+  }
+}
+
+// Load compiled modules
+const distDir = path.join(__dirname, '..', 'dist')
+if (!fs.existsSync(path.join(distDir, 'connection.js'))) {
+  console.error('❌  dist/ not found. Run `npm run build` first.')
+  process.exit(1)
+}
+const { getConnection, closeConnection } = require(path.join(distDir, 'connection'))
+const tracker = require('@hcengineering/tracker')
+
+// Parse args
+const args = process.argv.slice(2)
+const confirm = args.includes('--confirm')
+const positional = args.filter(a => !a.startsWith('--'))
+
+const [projectIdentifier, startStr, endStr] = positional
+if (!projectIdentifier || !startStr || !endStr) {
+  console.error('Usage: node scripts/cleanup-issues.js <project> <start> <end> [--confirm]')
+  console.error('Example: node scripts/cleanup-issues.js VISIO 59 68 --confirm')
+  process.exit(1)
+}
+
+const start = parseInt(startStr, 10)
+const end = parseInt(endStr, 10)
+if (isNaN(start) || isNaN(end) || start > end) {
+  console.error('❌  start and end must be valid numbers with start <= end')
+  process.exit(1)
+}
+
+async function main () {
+  const identifiers = []
+  for (let n = start; n <= end; n++) {
+    identifiers.push(`${projectIdentifier}-${n}`)
+  }
+
+  console.log(`\n🔍  Huly Issue Cleanup`)
+  console.log(`    Project:  ${projectIdentifier}`)
+  console.log(`    Range:    ${projectIdentifier}-${start} → ${projectIdentifier}-${end} (${identifiers.length} issues)`)
+  console.log(`    Mode:     ${confirm ? '⚠️  DELETING for real' : '👁  DRY RUN (pass --confirm to delete)'}\n`)
+
+  console.log('🔌  Connecting to Huly...')
+  const client = await getConnection()
+  console.log('✅  Connected.\n')
+
+  // Find all issues in the range
+  const issues = await client.findAll(
+    tracker.default.class.Issue,
+    { identifier: { $in: identifiers } }
+  )
+
+  if (issues.length === 0) {
+    console.log('✅  No matching issues found — nothing to delete.')
+    await closeConnection()
+    return
+  }
+
+  console.log(`Found ${issues.length} issue(s) to delete:\n`)
+  for (const issue of issues) {
+    console.log(`  • ${issue.identifier}  "${issue.title}"`)
+  }
+  console.log()
+
+  if (!confirm) {
+    console.log('ℹ️  This was a DRY RUN. To actually delete, run:')
+    console.log(`   node scripts/cleanup-issues.js ${projectIdentifier} ${start} ${end} --confirm\n`)
+    await closeConnection()
+    return
+  }
+
+  // Delete
+  let deleted = 0
+  let failed = 0
+
+  for (const issue of issues) {
+    process.stdout.write(`  Deleting ${issue.identifier}... `)
+    try {
+      await client.removeCollection(
+        tracker.default.class.Issue,
+        issue.space,
+        issue._id,
+        issue.attachedTo,
+        issue.attachedToClass,
+        issue.collection
+      )
+      console.log('✅')
+      deleted++
+    } catch (err) {
+      console.log(`❌ ${err.message}`)
+      failed++
+    }
+  }
+
+  await closeConnection()
+
+  console.log(`\n${'─'.repeat(50)}`)
+  console.log(`✅  Deleted: ${deleted}   ❌ Failed: ${failed}`)
+  console.log(`${'─'.repeat(50)}\n`)
+}
+
+main().catch(err => {
+  console.error('\n❌  Fatal error:', err.message)
+  process.exit(1)
+})