devto-mcp 0.4.4 → 0.4.5

package/dist/tools.d.ts

@@ -20,7 +20,7 @@ export declare function createEpic(title: string, description: string): Promise<
 export declare function createTask(title: string, description: string, epicKey?: string, issueType?: string): Promise<string>;
 export declare function createSubtask(title: string, description: string, parentKey: string): Promise<string>;
 export declare function getTasks(epicKey?: string): Promise<string>;
-export declare function updateTask(issueKey: string, status?: string, comment?: string, assignee?: string, priority?: string, labels?: string[], epicKey?: string): Promise<string>;
+export declare function updateTask(issueKey: string, status?: string, comment?: string, assignee?: string, priority?: string, labels?: string[], epicKey?: string, title?: string, description?: string): Promise<string>;
 export declare function getComments(issueKey: string): Promise<string>;
 export declare function getProjectSummary(): Promise<string>;
 export declare function listEpics(): Promise<string>;
@@ -34,4 +34,33 @@ export declare function createSprintTool(name: string, startDate?: string, endDa
 export declare function moveToSprintTool(sprintId: string, issueKeys: string[]): Promise<string>;
 export declare function manageSprintTool(sprintId: string, action: string): Promise<string>;
 export declare function getStatus(): Promise<string>;
+export declare function searchIssues(jql: string, maxResults?: number): Promise<string>;
+export declare function getCustomFields(): Promise<string>;
+export declare function linkIssues(issueKey1: string, issueKey2: string, linkType: string): Promise<string>;
+export declare function getIssueLinks(issueKey: string): Promise<string>;
+export declare function getLinkTypes(): Promise<string>;
+export declare function logWork(issueKey: string, timeSpent: string, comment?: string): Promise<string>;
+export declare function getWorklog(issueKey: string): Promise<string>;
+export declare function setEstimate(issueKey: string, estimate: string): Promise<string>;
+export declare function listVersions(): Promise<string>;
+export declare function createVersion(name: string, description?: string, releaseDate?: string): Promise<string>;
+export declare function releaseVersion(versionName: string): Promise<string>;
+export declare function getBacklog(): Promise<string>;
+export declare function moveToBacklog(issueKeys: string[]): Promise<string>;
+export declare function bulkCreateTasks(tasks: Array<{
+    title: string;
+    description: string;
+    type?: string;
+    epic_key?: string;
+}>): Promise<string>;
+export declare function bulkUpdateTasks(updates: Array<{
+    issue_key: string;
+    status?: string;
+    comment?: string;
+    assignee?: string;
+    priority?: string;
+}>): Promise<string>;
+export declare function attachFile(issueKey: string, filePath: string): Promise<string>;
+export declare function listAttachments(issueKey: string): Promise<string>;
+export declare function manageWatchers(issueKey: string, action: string, userName?: string): Promise<string>;
 //# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

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

package/dist/tools.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -24,9 +57,50 @@ exports.createSprintTool = createSprintTool;
 exports.moveToSprintTool = moveToSprintTool;
 exports.manageSprintTool = manageSprintTool;
 exports.getStatus = getStatus;
+exports.searchIssues = searchIssues;
+exports.getCustomFields = getCustomFields;
+exports.linkIssues = linkIssues;
+exports.getIssueLinks = getIssueLinks;
+exports.getLinkTypes = getLinkTypes;
+exports.logWork = logWork;
+exports.getWorklog = getWorklog;
+exports.setEstimate = setEstimate;
+exports.listVersions = listVersions;
+exports.createVersion = createVersion;
+exports.releaseVersion = releaseVersion;
+exports.getBacklog = getBacklog;
+exports.moveToBacklog = moveToBacklog;
+exports.bulkCreateTasks = bulkCreateTasks;
+exports.bulkUpdateTasks = bulkUpdateTasks;
+exports.attachFile = attachFile;
+exports.listAttachments = listAttachments;
+exports.manageWatchers = manageWatchers;
 const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
 const client_1 = require("./client");
 const config_1 = require("./config");
+// ─── Content sanitization (prompt injection defense) ─────────────────────────
+/**
+ * Wrap user-authored content from Jira in boundary markers so the LLM
+ * knows it's untrusted external content, not system instructions.
+ */
+function sanitizeUserContent(text) {
+    if (!text)
+        return text;
+    // Strip common prompt injection patterns
+    const cleaned = text
+        .replace(/ignore (?:all )?previous instructions/gi, "[filtered]")
+        .replace(/you are now/gi, "[filtered]")
+        .replace(/system:\s/gi, "[filtered] ");
+    return cleaned;
+}
+/**
+ * Sanitize a task title from Jira (lightweight — just strips injection patterns).
+ */
+function sanitizeTitle(title) {
+    return sanitizeUserContent(title);
+}
 // ─── Anthropic system prompt ────────────────────────────────────────────────
 const PLAN_SYSTEM_PROMPT = `You are DevTo, an AI work manager for software developers. Your job is to take a feature description and break it into a structured development plan. Always return a JSON object with this exact structure and nothing else — no preamble, no markdown, just the JSON:
 {
@@ -311,16 +385,16 @@ async function getTasks(epicKey) {
         ``,
     ];
     res.tasks.forEach((task) => {
-        lines.push(`**${task.key}** — ${task.title}`);
+        lines.push(`**${task.key}** — ${sanitizeTitle(task.title)}`);
         lines.push(`  Status: ${task.status} | Type: ${task.type}${task.assignee ? ` | Assignee: ${task.assignee}` : ""}`);
         if (task.parent)
-            lines.push(`  Parent: ${task.parent.key} — ${task.parent.title}`);
+            lines.push(`  Parent: ${task.parent.key} — ${sanitizeTitle(task.parent.title)}`);
         lines.push(`  ${task.url}`);
         lines.push(``);
     });
     return lines.join("\n");
 }
-async function updateTask(issueKey, status, comment, assignee, priority, labels, epicKey) {
+async function updateTask(issueKey, status, comment, assignee, priority, labels, epicKey, title, description) {
     // Resolve ambiguous references
     const resolved = await resolveIssueKey(issueKey);
     if (!resolved.resolved) {
@@ -348,8 +422,16 @@ async function updateTask(issueKey, status, comment, assignee, priority, labels,
         body.labels = labels;
     if (resolvedEpicKey)
         body.epic_key = resolvedEpicKey;
+    if (title)
+        body.title = title;
+    if (description)
+        body.description = description;
     const res = await (0, client_1.callApi)("PUT", `/api/v1/task/${resolved.key}`, body);
     const parts = [];
+    if (title)
+        parts.push(`Renamed **${resolved.key}** to "${title}".`);
+    if (description)
+        parts.push(`Updated description for **${resolved.key}**.`);
     if (status)
         parts.push(`Moved **${resolved.key}** to \`${status}\`.`);
     if (res.comment)
@@ -382,7 +464,7 @@ async function getComments(issueKey) {
     res.comments.forEach((c) => {
         const date = new Date(c.created).toLocaleDateString();
         lines.push(`**${c.author}** (${date}):`);
-        lines.push(c.body);
+        lines.push(sanitizeUserContent(c.body));
         lines.push(``);
     });
     return lines.join("\n");
@@ -408,11 +490,11 @@ async function getProjectSummary() {
     }
     lines.push(`### Active Tasks`);
     res.issues.forEach((issue) => {
-        const parts = [`**${issue.key}** — ${issue.title} (${issue.status})`];
+        const parts = [`**${issue.key}** — ${sanitizeTitle(issue.title)} (${issue.status})`];
         if (issue.assignee)
             parts.push(`  Assignee: ${issue.assignee}`);
         if (issue.parent_key)
-            parts.push(`  Parent: ${issue.parent_key}${issue.epic_name ? ` — ${issue.epic_name}` : ""}`);
+            parts.push(`  Parent: ${issue.parent_key}${issue.epic_name ? ` — ${sanitizeTitle(issue.epic_name)}` : ""}`);
         lines.push(parts.join("\n"));
         lines.push(``);
     });
@@ -628,4 +710,382 @@ async function getStatus() {
     }
     return lines.join("\n");
 }
+async function searchIssues(jql, maxResults) {
+    const res = await (0, client_1.callApi)("POST", "/api/v1/search", {
+        jql,
+        max_results: maxResults ?? 50,
+    });
+    if (res.total === 0) {
+        return `No issues found matching JQL: \`${jql}\``;
+    }
+    const lines = [
+        `## Search Results (${res.total} total)`,
+        ``,
+        `| Key | Title | Status | Type | Assignee |`,
+        `|-----|-------|--------|------|----------|`,
+    ];
+    res.issues.forEach((issue) => {
+        lines.push(`| ${issue.key} | ${issue.title} | ${issue.status} | ${issue.type} | ${issue.assignee ?? "—"} |`);
+    });
+    if (res.total > res.issues.length) {
+        lines.push(``, `_Showing ${res.issues.length} of ${res.total}. Refine your JQL for more specific results._`);
+    }
+    return lines.join("\n");
+}
+async function getCustomFields() {
+    const res = await (0, client_1.callApi)("GET", "/api/v1/fields");
+    if (res.total === 0) {
+        return "No custom fields found in the project.";
+    }
+    const lines = [
+        `## Custom Fields (${res.total})`,
+        ``,
+        `| ID | Name | Type | Required |`,
+        `|----|------|------|----------|`,
+    ];
+    res.fields.forEach((field) => {
+        lines.push(`| ${field.id} | ${field.name} | ${field.type} | ${field.required ? "Yes" : "No"} |`);
+    });
+    return lines.join("\n");
+}
+// ─── Issue Linking ────────────────────────────────────────────────────────────
+async function linkIssues(issueKey1, issueKey2, linkType) {
+    const resolved1 = await resolveIssueKey(issueKey1);
+    if (!resolved1.resolved) {
+        return resolved1.prompt;
+    }
+    const resolved2 = await resolveIssueKey(issueKey2);
+    if (!resolved2.resolved) {
+        return resolved2.prompt;
+    }
+    await (0, client_1.callApi)("POST", "/api/v1/issues/link", {
+        inward_key: resolved1.key,
+        outward_key: resolved2.key,
+        link_type: linkType,
+    });
+    return `Linked **${resolved1.key}** → **${resolved2.key}** (${linkType}).`;
+}
+async function getIssueLinks(issueKey) {
+    const resolved = await resolveIssueKey(issueKey);
+    if (!resolved.resolved) {
+        return resolved.prompt;
+    }
+    const res = await (0, client_1.callApi)("GET", `/api/v1/issues/${resolved.key}/links`);
+    if (res.total === 0) {
+        return `No links found on **${resolved.key}**.`;
+    }
+    const lines = [
+        `## Links on ${resolved.key} (${res.total})`,
+        ``,
+    ];
+    res.links.forEach((link) => {
+        if (link.inwardIssue) {
+            lines.push(`- **${link.type}** ← ${link.inwardIssue.key} — ${link.inwardIssue.title} (${link.inwardIssue.status})`);
+        }
+        if (link.outwardIssue) {
+            lines.push(`- **${link.type}** → ${link.outwardIssue.key} — ${link.outwardIssue.title} (${link.outwardIssue.status})`);
+        }
+    });
+    return lines.join("\n");
+}
+async function getLinkTypes() {
+    const res = await (0, client_1.callApi)("GET", "/api/v1/issues/link-types");
+    if (res.total === 0) {
+        return "No link types available.";
+    }
+    const lines = [
+        `## Link Types (${res.total})`,
+        ``,
+        `| Name | Inward | Outward |`,
+        `|------|--------|---------|`,
+    ];
+    res.link_types.forEach((lt) => {
+        lines.push(`| ${lt.name} | ${lt.inward} | ${lt.outward} |`);
+    });
+    return lines.join("\n");
+}
+async function logWork(issueKey, timeSpent, comment) {
+    const resolved = await resolveIssueKey(issueKey);
+    if (!resolved.resolved) {
+        return resolved.prompt;
+    }
+    const body = { time_spent: timeSpent };
+    if (comment)
+        body.comment = comment;
+    await (0, client_1.callApi)("POST", `/api/v1/issues/${resolved.key}/worklog`, body);
+    return `Logged **${timeSpent}** on **${resolved.key}**.${comment ? ` Comment: "${comment}"` : ""}`;
+}
+async function getWorklog(issueKey) {
+    const resolved = await resolveIssueKey(issueKey);
+    if (!resolved.resolved) {
+        return resolved.prompt;
+    }
+    const res = await (0, client_1.callApi)("GET", `/api/v1/issues/${resolved.key}/worklog`);
+    if (res.total === 0) {
+        return `No work logged on **${resolved.key}**.`;
+    }
+    const lines = [
+        `## Work Log — ${resolved.key} (${res.total} entries)`,
+        ``,
+    ];
+    res.worklogs.forEach((entry) => {
+        const date = new Date(entry.started).toLocaleDateString();
+        lines.push(`**${entry.author}** — ${entry.time_spent} (${date})`);
+        if (entry.comment)
+            lines.push(`  ${entry.comment}`);
+        lines.push(``);
+    });
+    return lines.join("\n");
+}
+async function setEstimate(issueKey, estimate) {
+    const resolved = await resolveIssueKey(issueKey);
+    if (!resolved.resolved) {
+        return resolved.prompt;
+    }
+    await (0, client_1.callApi)("PUT", `/api/v1/issues/${resolved.key}/time`, {
+        original_estimate: estimate,
+    });
+    return `Set estimate for **${resolved.key}** to **${estimate}**.`;
+}
+async function listVersions() {
+    const res = await (0, client_1.callApi)("GET", "/api/v1/versions");
+    if (res.total === 0) {
+        return "No versions found in the project. Use `create_version` to create one.";
+    }
+    const lines = [
+        `## Versions (${res.total})`,
+        ``,
+    ];
+    res.versions.forEach((v) => {
+        const status = v.released ? "Released" : "Unreleased";
+        const date = v.release_date ? ` (${v.release_date})` : "";
+        lines.push(`**${v.name}** — ${status}${date}`);
+        if (v.description)
+            lines.push(`  ${v.description}`);
+        lines.push(``);
+    });
+    return lines.join("\n");
+}
+async function createVersion(name, description, releaseDate) {
+    const body = { name };
+    if (description)
+        body.description = description;
+    if (releaseDate)
+        body.release_date = releaseDate;
+    const res = await (0, client_1.callApi)("POST", "/api/v1/versions", body);
+    return `Version **${res.name}** created (ID: ${res.id}).`;
+}
+async function releaseVersion(versionName) {
+    // Find version by name
+    const versions = await (0, client_1.callApi)("GET", "/api/v1/versions");
+    const match = versions.versions.find((v) => v.name.toLowerCase() === versionName.toLowerCase() || v.id === versionName);
+    if (!match) {
+        return `No version found matching "${versionName}". Use \`list_versions\` to see available versions.`;
+    }
+    if (match.released) {
+        return `Version **${match.name}** is already released.`;
+    }
+    await (0, client_1.callApi)("PUT", `/api/v1/versions/${match.id}`, {
+        released: true,
+        release_date: new Date().toISOString().split("T")[0],
+    });
+    return `Version **${match.name}** marked as released.`;
+}
+async function getBacklog() {
+    const res = await (0, client_1.callApi)("GET", "/api/v1/backlog");
+    if (res.total === 0) {
+        return "Backlog is empty — all issues are assigned to sprints.";
+    }
+    const lines = [
+        `## Backlog (${res.total} issues)`,
+        ``,
+    ];
+    res.issues.forEach((issue) => {
+        lines.push(`**${issue.key}** — ${issue.title}`);
+        lines.push(`  Status: ${issue.status} | Type: ${issue.type}${issue.assignee ? ` | Assignee: ${issue.assignee}` : ""}`);
+        if (issue.parent)
+            lines.push(`  Parent: ${issue.parent.key} — ${issue.parent.title}`);
+        lines.push(``);
+    });
+    return lines.join("\n");
+}
+async function moveToBacklog(issueKeys) {
+    const resolvedKeys = [];
+    for (const key of issueKeys) {
+        const resolved = await resolveIssueKey(key);
+        if (!resolved.resolved) {
+            return resolved.prompt;
+        }
+        resolvedKeys.push(resolved.key);
+    }
+    await (0, client_1.callApi)("POST", "/api/v1/backlog", {
+        issue_keys: resolvedKeys,
+    });
+    return `Moved **${resolvedKeys.join(", ")}** to backlog.`;
+}
+// ─── Bulk Operations ──────────────────────────────────────────────────────────
+async function bulkCreateTasks(tasks) {
+    const results = [];
+    for (const task of tasks) {
+        try {
+            const body = { title: task.title, description: task.description };
+            if (task.type)
+                body.type = task.type;
+            if (task.epic_key)
+                body.epic_key = task.epic_key;
+            const res = await (0, client_1.callApi)("POST", "/api/v1/task", body);
+            results.push({ key: res.key, title: task.title });
+        }
+        catch (err) {
+            results.push({
+                key: "FAILED",
+                title: task.title,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    const succeeded = results.filter((r) => r.key !== "FAILED");
+    const failed = results.filter((r) => r.key === "FAILED");
+    const lines = [
+        `## Bulk Create — ${succeeded.length}/${tasks.length} succeeded`,
+        ``,
+    ];
+    succeeded.forEach((r) => {
+        lines.push(`- **${r.key}** — ${r.title}`);
+    });
+    if (failed.length > 0) {
+        lines.push(``, `### Failed (${failed.length})`);
+        failed.forEach((r) => {
+            lines.push(`- ${r.title}: ${r.error}`);
+        });
+    }
+    return lines.join("\n");
+}
+async function bulkUpdateTasks(updates) {
+    const results = [];
+    for (const update of updates) {
+        const resolved = await resolveIssueKey(update.issue_key);
+        if (!resolved.resolved) {
+            results.push({ key: update.issue_key, success: false, error: "Could not resolve issue key" });
+            continue;
+        }
+        try {
+            const body = {};
+            if (update.status)
+                body.status = update.status;
+            if (update.comment)
+                body.comment = update.comment;
+            if (update.assignee)
+                body.assignee = update.assignee;
+            if (update.priority)
+                body.priority = update.priority;
+            await (0, client_1.callApi)("PUT", `/api/v1/task/${resolved.key}`, body);
+            results.push({ key: resolved.key, success: true });
+        }
+        catch (err) {
+            results.push({
+                key: resolved.key,
+                success: false,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    const succeeded = results.filter((r) => r.success);
+    const failed = results.filter((r) => !r.success);
+    const lines = [
+        `## Bulk Update — ${succeeded.length}/${updates.length} succeeded`,
+        ``,
+    ];
+    succeeded.forEach((r) => {
+        lines.push(`- **${r.key}** updated`);
+    });
+    if (failed.length > 0) {
+        lines.push(``, `### Failed (${failed.length})`);
+        failed.forEach((r) => {
+            lines.push(`- **${r.key}**: ${r.error}`);
+        });
+    }
+    return lines.join("\n");
+}
+async function attachFile(issueKey, filePath) {
+    const resolved = await resolveIssueKey(issueKey);
+    if (!resolved.resolved) {
+        return resolved.prompt;
+    }
+    // Read the file from the local filesystem
+    let fileBuffer;
+    try {
+        fileBuffer = fs.readFileSync(filePath);
+    }
+    catch (err) {
+        return `Could not read file at \`${filePath}\`: ${err instanceof Error ? err.message : String(err)}`;
+    }
+    const filename = path.basename(filePath);
+    const contentBase64 = fileBuffer.toString("base64");
+    await (0, client_1.callApi)("POST", `/api/v1/issues/${resolved.key}/attachments`, {
+        filename,
+        content_base64: contentBase64,
+    });
+    return `Attached **${filename}** to **${resolved.key}**.`;
+}
+async function listAttachments(issueKey) {
+    const resolved = await resolveIssueKey(issueKey);
+    if (!resolved.resolved) {
+        return resolved.prompt;
+    }
+    const res = await (0, client_1.callApi)("GET", `/api/v1/issues/${resolved.key}/attachments`);
+    if (res.total === 0) {
+        return `No attachments on **${resolved.key}**.`;
+    }
+    const lines = [
+        `## Attachments on ${resolved.key} (${res.total})`,
+        ``,
+    ];
+    res.attachments.forEach((a) => {
+        const size = a.size < 1024 ? `${a.size}B` : a.size < 1048576 ? `${Math.round(a.size / 1024)}KB` : `${(a.size / 1048576).toFixed(1)}MB`;
+        const date = new Date(a.created).toLocaleDateString();
+        lines.push(`- **${a.filename}** (${size}) — ${a.author}, ${date}`);
+    });
+    return lines.join("\n");
+}
+async function manageWatchers(issueKey, action, userName) {
+    const resolved = await resolveIssueKey(issueKey);
+    if (!resolved.resolved) {
+        return resolved.prompt;
+    }
+    switch (action) {
+        case "list": {
+            const res = await (0, client_1.callApi)("GET", `/api/v1/issues/${resolved.key}/watchers`);
+            if (res.total === 0) {
+                return `No watchers on **${resolved.key}**.`;
+            }
+            const lines = [
+                `## Watchers on ${resolved.key} (${res.total})`,
+                ``,
+            ];
+            res.watchers.forEach((w) => {
+                lines.push(`- ${w.display_name}`);
+            });
+            return lines.join("\n");
+        }
+        case "add": {
+            if (!userName) {
+                return `User name is required for the "add" action. Provide the display name of the person to add as a watcher.`;
+            }
+            await (0, client_1.callApi)("POST", `/api/v1/issues/${resolved.key}/watchers`, {
+                user_name: userName,
+            });
+            return `Added **${userName}** as watcher on **${resolved.key}**.`;
+        }
+        case "remove": {
+            if (!userName) {
+                return `User name is required for the "remove" action. Provide the display name of the person to remove as a watcher.`;
+            }
+            await (0, client_1.callApi)("DELETE", `/api/v1/issues/${resolved.key}/watchers?user_name=${encodeURIComponent(userName)}`);
+            return `Removed **${userName}** as watcher from **${resolved.key}**.`;
+        }
+        default:
+            return `Invalid action "${action}". Use "list", "add", or "remove".`;
+    }
+}
 //# sourceMappingURL=tools.js.map