harmony-mcp 1.1.0 → 1.2.0

package/README.md

@@ -70,12 +70,12 @@ Or add to `~/.claude/settings.json`:
 
 ## Supported AI Agents
 
-| Agent | MCP Config | Workflow Command |
-|-------|-----------|------------------|
-| **Claude Code** | `~/.claude/settings.json` | `/hmy #42` |
-| **OpenAI Codex** | `~/.codex/config.toml` | `/prompts:hmy #42` |
-| **Cursor** | `.cursor/mcp.json` | MCP tools auto-available |
-| **Windsurf** | `~/.codeium/windsurf/mcp_config.json` | MCP tools auto-available |
+| Agent            | MCP Config                            | Workflow Command         |
+| ---------------- | ------------------------------------- | ------------------------ |
+| **Claude Code**  | `~/.claude/settings.json`             | `/hmy #42`               |
+| **OpenAI Codex** | `~/.codex/config.toml`                | `/prompts:hmy #42`       |
+| **Cursor**       | `.cursor/mcp.json`                    | MCP tools auto-available |
+| **Windsurf**     | `~/.codeium/windsurf/mcp_config.json` | MCP tools auto-available |
 
 ## Card Workflow
 
@@ -106,6 +106,7 @@ harmony-mcp serve              # Start MCP server
 ## Available Tools
 
 ### Card Operations
+
 - `harmony_create_card` - Create a new card
 - `harmony_update_card` - Update card properties
 - `harmony_move_card` - Move card to different column
@@ -115,21 +116,25 @@ harmony-mcp serve              # Start MCP server
 - `harmony_get_card` - Get card details
 
 ### Column Operations
+
 - `harmony_create_column` - Create new column
 - `harmony_update_column` - Update column properties
 - `harmony_delete_column` - Delete column
 
 ### Label Operations
+
 - `harmony_create_label` - Create new label
 - `harmony_add_label_to_card` - Add label to card
 - `harmony_remove_label_from_card` - Remove label
 
 ### Subtask Operations
+
 - `harmony_create_subtask` - Create subtask
 - `harmony_toggle_subtask` - Toggle completion
 - `harmony_delete_subtask` - Delete subtask
 
 ### Context Operations
+
 - `harmony_list_workspaces` - List workspaces
 - `harmony_list_projects` - List projects
 - `harmony_get_board` - Get full board state
@@ -139,9 +144,11 @@ harmony-mcp serve              # Start MCP server
 - `harmony_get_context` - Get current context
 
 ### Natural Language
+
 - `harmony_process_command` - Process natural language commands
 
 ### Agent Session Tracking
+
 - `harmony_start_agent_session` - Start tracking work on a card
 - `harmony_update_agent_progress` - Update progress, status, blockers
 - `harmony_end_agent_session` - End session (completed/paused)
@@ -158,28 +165,28 @@ curl -X GET "https://gethmy.com/api/workspaces" \
 
 ### API Endpoints
 
-| Endpoint | Method | Description |
-|----------|--------|-------------|
-| `/workspaces` | GET | List workspaces |
-| `/workspaces/:id/projects` | GET | List projects in workspace |
-| `/workspaces/:id/members` | GET | Get workspace members |
-| `/board/:projectId` | GET | Get full board state |
-| `/cards` | POST | Create card |
-| `/cards/:id` | GET | Get card |
-| `/cards/:id` | PATCH | Update card |
-| `/cards/:id` | DELETE | Delete card |
-| `/cards/:id/move` | POST | Move card |
-| `/search?q=query` | GET | Search cards |
-| `/columns` | POST | Create column |
-| `/columns/:id` | PATCH | Update column |
-| `/columns/:id` | DELETE | Delete column |
-| `/labels` | POST | Create label |
-| `/cards/:id/labels` | POST | Add label to card |
-| `/cards/:id/labels/:labelId` | DELETE | Remove label |
-| `/subtasks` | POST | Create subtask |
-| `/subtasks/:id/toggle` | POST | Toggle subtask |
-| `/subtasks/:id` | DELETE | Delete subtask |
-| `/nlu` | POST | Process natural language |
+| Endpoint                     | Method | Description                |
+| ---------------------------- | ------ | -------------------------- |
+| `/workspaces`                | GET    | List workspaces            |
+| `/workspaces/:id/projects`   | GET    | List projects in workspace |
+| `/workspaces/:id/members`    | GET    | Get workspace members      |
+| `/board/:projectId`          | GET    | Get full board state       |
+| `/cards`                     | POST   | Create card                |
+| `/cards/:id`                 | GET    | Get card                   |
+| `/cards/:id`                 | PATCH  | Update card                |
+| `/cards/:id`                 | DELETE | Delete card                |
+| `/cards/:id/move`            | POST   | Move card                  |
+| `/search?q=query`            | GET    | Search cards               |
+| `/columns`                   | POST   | Create column              |
+| `/columns/:id`               | PATCH  | Update column              |
+| `/columns/:id`               | DELETE | Delete column              |
+| `/labels`                    | POST   | Create label               |
+| `/cards/:id/labels`          | POST   | Add label to card          |
+| `/cards/:id/labels/:labelId` | DELETE | Remove label               |
+| `/subtasks`                  | POST   | Create subtask             |
+| `/subtasks/:id/toggle`       | POST   | Toggle subtask             |
+| `/subtasks/:id`              | DELETE | Delete subtask             |
+| `/nlu`                       | POST   | Process natural language   |
 
 ## Configuration
 
@@ -211,13 +218,14 @@ Your configuration is stored in `~/.harmony-mcp/config.json`:
                                                    │
                                                    ▼
                                           ┌──────────────────┐
-                                          │    Supabase      │
-                                          │    (Database)    │
+                                          │    Database      │
+                                          │    (Supabase)    │
                                           └──────────────────┘
 ```
 
 **Key Benefits:**
-- No Supabase credentials needed - just a Harmony API key
+
+- No Database credentials needed - just a Harmony API key
 - Any Harmony user can use it
 - Business logic stays in Harmony
 - Centralized security and rate limiting

package/dist/cli.js

@@ -25384,6 +25384,15 @@ class HarmonyApiClient {
   async removeLabelFromCard(cardId, labelId) {
     return this.request("DELETE", `/cards/${cardId}/labels/${labelId}`);
   }
+  async addLinkToCard(sourceCardId, targetCardId, linkType) {
+    return this.request("POST", `/cards/${sourceCardId}/links`, { targetCardId, linkType });
+  }
+  async removeLinkFromCard(linkId) {
+    return this.request("DELETE", `/card-links/${linkId}`);
+  }
+  async getCardLinks(cardId) {
+    return this.request("GET", `/cards/${cardId}/links`);
+  }
   async createColumn(projectId, name) {
     return this.request("POST", "/columns", { projectId, name });
   }
@@ -25433,6 +25442,312 @@ function getClient() {
   return client;
 }
 
+// src/prompt-builder.ts
+var LABEL_CATEGORY_MAP = {
+  bug: "bug",
+  fix: "bug",
+  hotfix: "bug",
+  defect: "bug",
+  issue: "bug",
+  error: "bug",
+  feature: "feature",
+  enhancement: "feature",
+  improvement: "feature",
+  new: "feature",
+  design: "design",
+  ui: "design",
+  ux: "design",
+  frontend: "design",
+  styling: "design",
+  review: "review",
+  "code review": "review",
+  pr: "review",
+  feedback: "review",
+  onboarding: "onboarding",
+  documentation: "onboarding",
+  docs: "onboarding",
+  guide: "onboarding",
+  tutorial: "onboarding",
+  epic: "epic",
+  initiative: "epic",
+  project: "epic",
+  milestone: "epic"
+};
+var DEFAULT_ROLE_FRAMINGS = {
+  bug: {
+    category: "bug",
+    role: "Senior QA Engineer and Software Developer",
+    perspective: "You are investigating and fixing a bug report.",
+    focus: [
+      "Root cause analysis",
+      "Steps to reproduce",
+      "Impact assessment",
+      "Fix implementation",
+      "Regression prevention",
+      "Test cases to prevent recurrence"
+    ],
+    outputSuggestions: [
+      "Bug triage summary",
+      "Root cause explanation",
+      "Fix implementation plan",
+      "Test cases"
+    ]
+  },
+  feature: {
+    category: "feature",
+    role: "Product Engineer",
+    perspective: "You are implementing a new feature or enhancement.",
+    focus: [
+      "User requirements",
+      "Technical specification",
+      "Implementation approach",
+      "Edge cases",
+      "Acceptance criteria",
+      "Integration points"
+    ],
+    outputSuggestions: [
+      "Technical specification",
+      "Implementation tasks",
+      "Acceptance criteria checklist",
+      "API design"
+    ]
+  },
+  design: {
+    category: "design",
+    role: "UX Designer and Frontend Developer",
+    perspective: "You are designing and implementing a user interface.",
+    focus: [
+      "User experience flow",
+      "Visual design consistency",
+      "Accessibility (WCAG)",
+      "Responsive behavior",
+      "Component architecture",
+      "Interaction patterns"
+    ],
+    outputSuggestions: [
+      "User flow diagram",
+      "Component specifications",
+      "Accessibility checklist",
+      "Responsive breakpoints"
+    ]
+  },
+  review: {
+    category: "review",
+    role: "Code Reviewer and Technical Lead",
+    perspective: "You are reviewing code for quality, correctness, and maintainability.",
+    focus: [
+      "Code correctness",
+      "Performance implications",
+      "Security considerations",
+      "Testing coverage",
+      "Documentation",
+      "Best practices adherence"
+    ],
+    outputSuggestions: [
+      "Review checklist",
+      "Suggested improvements",
+      "Test scenarios",
+      "Security audit"
+    ]
+  },
+  onboarding: {
+    category: "onboarding",
+    role: "Technical Writer and Developer Advocate",
+    perspective: "You are creating documentation or onboarding materials.",
+    focus: [
+      "Clear step-by-step instructions",
+      "Prerequisites and setup",
+      "Common pitfalls",
+      "Examples and use cases",
+      "Troubleshooting guide",
+      "Related resources"
+    ],
+    outputSuggestions: [
+      "Getting started guide",
+      "Step-by-step tutorial",
+      "FAQ section",
+      "Troubleshooting guide"
+    ]
+  },
+  epic: {
+    category: "epic",
+    role: "Technical Project Manager and Architect",
+    perspective: "You are planning and coordinating a large initiative.",
+    focus: [
+      "Scope definition",
+      "Task breakdown",
+      "Dependencies",
+      "Risk assessment",
+      "Timeline considerations",
+      "Success metrics"
+    ],
+    outputSuggestions: [
+      "Epic breakdown into stories",
+      "Dependency graph",
+      "Risk mitigation plan",
+      "Success criteria"
+    ]
+  },
+  custom: {
+    category: "custom",
+    role: "Software Engineer",
+    perspective: "You are working on a software task.",
+    focus: [
+      "Understanding requirements",
+      "Implementation approach",
+      "Quality considerations",
+      "Testing strategy"
+    ],
+    outputSuggestions: [
+      "Implementation plan",
+      "Technical notes",
+      "Task checklist"
+    ]
+  }
+};
+var VARIANT_INSTRUCTIONS = {
+  analysis: `ANALYSIS MODE: Analyze this task thoroughly. Identify requirements, constraints, edge cases, and potential challenges. Do NOT implement anything yet - focus on understanding and planning.`,
+  draft: `DRAFT MODE: Create a detailed implementation plan with code structure, key decisions, and approach. Include pseudocode or skeleton code where helpful. This is for review before full implementation.`,
+  execute: `EXECUTE MODE: Implement this task completely. Write production-ready code following best practices. Include necessary tests and documentation.`
+};
+function inferCategoryFromLabels(labels) {
+  for (const label of labels) {
+    const normalizedName = label.name.toLowerCase().trim();
+    if (LABEL_CATEGORY_MAP[normalizedName]) {
+      return LABEL_CATEGORY_MAP[normalizedName];
+    }
+    for (const [key, category] of Object.entries(LABEL_CATEGORY_MAP)) {
+      if (normalizedName.includes(key) || key.includes(normalizedName)) {
+        return category;
+      }
+    }
+  }
+  return "custom";
+}
+function getRoleFraming(category) {
+  return DEFAULT_ROLE_FRAMINGS[category];
+}
+function estimateTokens(text) {
+  return Math.ceil(text.length / 4);
+}
+function formatSubtasks(subtasks) {
+  if (subtasks.length === 0)
+    return "";
+  const completed = subtasks.filter((s) => s.completed).length;
+  const lines = subtasks.map((s) => `  ${s.completed ? "[x]" : "[ ]"} ${s.title}`);
+  return `
+## Subtasks (${completed}/${subtasks.length} completed)
+${lines.join(`
+`)}`;
+}
+function formatLabels(labels) {
+  if (labels.length === 0)
+    return "";
+  return `
+**Labels:** ${labels.map((l) => l.name).join(", ")}`;
+}
+function formatLinkedCards(links) {
+  if (!links || links.length === 0)
+    return "";
+  const lines = links.map((link) => {
+    const prefix = link.direction === "outgoing" ? "->" : "<-";
+    return `  ${prefix} #${link.target_card.short_id}: ${link.target_card.title} (${link.display_type})`;
+  });
+  return `
+## Related Cards
+${lines.join(`
+`)}`;
+}
+function generatePrompt(options) {
+  const { card, column, variant, customConstraints } = options;
+  const contextOpts = {
+    includeTitle: true,
+    includeDescription: true,
+    includeLabels: true,
+    includeSubtasks: true,
+    includeActivity: false,
+    includeAssignee: true,
+    includeDueDate: true,
+    includePriority: true,
+    includeLinks: true,
+    includeColumn: true,
+    ...options.contextOptions
+  };
+  const labels = card.labels || [];
+  const subtasks = card.subtasks || [];
+  const links = card.links || [];
+  const category = inferCategoryFromLabels(labels);
+  const roleFraming = getRoleFraming(category);
+  const sections = [];
+  sections.push(`# Role: ${roleFraming.role}
+`);
+  sections.push(roleFraming.perspective);
+  sections.push("");
+  sections.push(VARIANT_INSTRUCTIONS[variant]);
+  sections.push("");
+  sections.push(`# Task: ${card.title}`);
+  if (contextOpts.includeColumn && column) {
+    sections.push(`**Status:** ${column.name}`);
+  }
+  if (contextOpts.includePriority) {
+    sections.push(`**Priority:** ${card.priority}`);
+  }
+  if (contextOpts.includeDueDate && card.due_date) {
+    sections.push(`**Due:** ${card.due_date}`);
+  }
+  if (contextOpts.includeAssignee && card.assignee) {
+    sections.push(`**Assignee:** ${card.assignee.full_name || card.assignee.email}`);
+  }
+  if (contextOpts.includeLabels && labels.length > 0) {
+    sections.push(formatLabels(labels));
+  }
+  if (contextOpts.includeDescription && card.description) {
+    sections.push(`
+## Description
+${card.description}`);
+  }
+  if (contextOpts.includeSubtasks && subtasks.length > 0) {
+    sections.push(formatSubtasks(subtasks));
+  }
+  if (contextOpts.includeLinks && links.length > 0) {
+    sections.push(formatLinkedCards(links));
+  }
+  sections.push(`
+## Focus Areas`);
+  roleFraming.focus.forEach((f) => {
+    sections.push(`- ${f}`);
+  });
+  sections.push(`
+## Suggested Outputs`);
+  roleFraming.outputSuggestions.forEach((s) => {
+    sections.push(`- ${s}`);
+  });
+  if (customConstraints) {
+    sections.push(`
+## Additional Instructions
+${customConstraints}`);
+  }
+  sections.push(`
+---
+*Card #${card.short_id} | Generated for ${variant} mode*`);
+  const prompt = sections.join(`
+`);
+  return {
+    prompt,
+    variant,
+    category,
+    role: roleFraming.role,
+    contextSummary: {
+      hasDescription: !!card.description,
+      labelCount: labels.length,
+      subtaskCount: subtasks.length,
+      completedSubtasks: subtasks.filter((s) => s.completed).length,
+      linkedCardCount: links.length
+    },
+    tokenEstimate: estimateTokens(prompt)
+  };
+}
+
 // src/server.ts
 var TOOLS = {
   harmony_create_card: {
@@ -25596,6 +25911,42 @@ var TOOLS = {
       required: ["cardId", "labelId"]
     }
   },
+  harmony_add_link_to_card: {
+    description: "Create a link between two cards. Link types: relates_to, blocks, duplicates, is_part_of",
+    inputSchema: {
+      type: "object",
+      properties: {
+        sourceCardId: { type: "string", description: "The card creating the link from" },
+        targetCardId: { type: "string", description: "The card being linked to" },
+        linkType: {
+          type: "string",
+          enum: ["relates_to", "blocks", "duplicates", "is_part_of"],
+          description: "Type of relationship: relates_to (generic), blocks (source blocks target), duplicates (source duplicates target), is_part_of (source is part of target)"
+        }
+      },
+      required: ["sourceCardId", "targetCardId", "linkType"]
+    }
+  },
+  harmony_remove_link_from_card: {
+    description: "Remove a link between cards",
+    inputSchema: {
+      type: "object",
+      properties: {
+        linkId: { type: "string", description: "The link ID to remove" }
+      },
+      required: ["linkId"]
+    }
+  },
+  harmony_get_card_links: {
+    description: "Get all links for a card",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: { type: "string", description: "Card ID to get links for" }
+      },
+      required: ["cardId"]
+    }
+  },
   harmony_create_subtask: {
     description: "Create a subtask on a card",
     inputSchema: {
@@ -25759,6 +26110,27 @@ var TOOLS = {
       },
       required: ["cardId"]
     }
+  },
+  harmony_generate_prompt: {
+    description: "Generate an AI-ready prompt from a card. Automatically infers role and focus based on labels (bug, feature, design, etc.). Use this to create context-rich prompts for working on cards.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: { type: "string", description: "Card ID (UUID) to generate prompt from" },
+        shortId: { type: "number", description: "Card short ID (e.g., 42 for #42) - alternative to cardId" },
+        projectId: { type: "string", description: "Project ID (required if using shortId, optional if context set)" },
+        variant: {
+          type: "string",
+          enum: ["analysis", "draft", "execute"],
+          description: "Prompt variant: analysis (understand/plan), draft (design solution), execute (implement fully). Default: execute"
+        },
+        includeSubtasks: { type: "boolean", description: "Include subtasks in prompt (default: true)" },
+        includeLinks: { type: "boolean", description: "Include linked cards in prompt (default: true)" },
+        includeDescription: { type: "boolean", description: "Include description in prompt (default: true)" },
+        customConstraints: { type: "string", description: "Additional instructions to append to the prompt" }
+      },
+      required: []
+    }
   }
 };
 var RESOURCES = [
@@ -26001,6 +26373,23 @@ Include: cards moved recently, current in-progress items, blocked or high-priori
         await client2.removeLabelFromCard(cardId, labelId);
         return { success: true };
       }
+      case "harmony_add_link_to_card": {
+        const sourceCardId = exports_external.string().uuid().parse(args.sourceCardId);
+        const targetCardId = exports_external.string().uuid().parse(args.targetCardId);
+        const linkType = exports_external.enum(["relates_to", "blocks", "duplicates", "is_part_of"]).parse(args.linkType);
+        const result = await client2.addLinkToCard(sourceCardId, targetCardId, linkType);
+        return { success: true, ...result };
+      }
+      case "harmony_remove_link_from_card": {
+        const linkId = exports_external.string().uuid().parse(args.linkId);
+        await client2.removeLinkFromCard(linkId);
+        return { success: true };
+      }
+      case "harmony_get_card_links": {
+        const cardId = exports_external.string().uuid().parse(args.cardId);
+        const result = await client2.getCardLinks(cardId);
+        return result;
+      }
       case "harmony_create_subtask": {
         const cardId = exports_external.string().uuid().parse(args.cardId);
         const title = exports_external.string().min(1).parse(args.title);
@@ -26118,6 +26507,61 @@ Include: cards moved recently, current in-progress items, blocked or high-priori
         });
         return { success: true, ...result };
       }
+      case "harmony_generate_prompt": {
+        let cardData;
+        let columnData = null;
+        if (args.cardId) {
+          const cardId = exports_external.string().uuid().parse(args.cardId);
+          const cardResult = await client2.getCard(cardId);
+          cardData = cardResult.card;
+        } else if (args.shortId !== undefined) {
+          const shortId = exports_external.number().int().positive().parse(args.shortId);
+          const projectId = args.projectId || getActiveProjectId();
+          if (!projectId) {
+            throw new Error("Project ID required when using shortId. Use harmony_set_project_context or provide projectId.");
+          }
+          const cardResult = await client2.getCardByShortId(projectId, shortId);
+          cardData = cardResult.card;
+        } else {
+          throw new Error("Either cardId or shortId must be provided");
+        }
+        const projectIdForBoard = args.projectId || getActiveProjectId() || cardData.project_id;
+        if (projectIdForBoard) {
+          try {
+            const board = await client2.getBoard(projectIdForBoard, { summary: true });
+            const columnId = cardData.column_id;
+            const column = board.columns.find((col) => col.id === columnId);
+            if (column) {
+              columnData = { name: column.name };
+            }
+          } catch {}
+        }
+        const variant = args.variant || "execute";
+        const contextOptions = {};
+        if (args.includeSubtasks !== undefined) {
+          contextOptions.includeSubtasks = args.includeSubtasks === true || args.includeSubtasks === "true";
+        }
+        if (args.includeLinks !== undefined) {
+          contextOptions.includeLinks = args.includeLinks === true || args.includeLinks === "true";
+        }
+        if (args.includeDescription !== undefined) {
+          contextOptions.includeDescription = args.includeDescription === true || args.includeDescription === "true";
+        }
+        const result = generatePrompt({
+          card: cardData,
+          column: columnData,
+          variant,
+          contextOptions,
+          customConstraints: args.customConstraints
+        });
+        return {
+          success: true,
+          cardId: cardData.id,
+          shortId: cardData.short_id,
+          title: cardData.title,
+          ...result
+        };
+      }
       default:
         throw new Error(`Unknown tool: ${name}`);
     }

package/dist/index.js

@@ -23146,6 +23146,15 @@ class HarmonyApiClient {
   async removeLabelFromCard(cardId, labelId) {
     return this.request("DELETE", `/cards/${cardId}/labels/${labelId}`);
   }
+  async addLinkToCard(sourceCardId, targetCardId, linkType) {
+    return this.request("POST", `/cards/${sourceCardId}/links`, { targetCardId, linkType });
+  }
+  async removeLinkFromCard(linkId) {
+    return this.request("DELETE", `/card-links/${linkId}`);
+  }
+  async getCardLinks(cardId) {
+    return this.request("GET", `/cards/${cardId}/links`);
+  }
   async createColumn(projectId, name) {
     return this.request("POST", "/columns", { projectId, name });
   }
@@ -23195,6 +23204,312 @@ function getClient() {
   return client;
 }
 
+// src/prompt-builder.ts
+var LABEL_CATEGORY_MAP = {
+  bug: "bug",
+  fix: "bug",
+  hotfix: "bug",
+  defect: "bug",
+  issue: "bug",
+  error: "bug",
+  feature: "feature",
+  enhancement: "feature",
+  improvement: "feature",
+  new: "feature",
+  design: "design",
+  ui: "design",
+  ux: "design",
+  frontend: "design",
+  styling: "design",
+  review: "review",
+  "code review": "review",
+  pr: "review",
+  feedback: "review",
+  onboarding: "onboarding",
+  documentation: "onboarding",
+  docs: "onboarding",
+  guide: "onboarding",
+  tutorial: "onboarding",
+  epic: "epic",
+  initiative: "epic",
+  project: "epic",
+  milestone: "epic"
+};
+var DEFAULT_ROLE_FRAMINGS = {
+  bug: {
+    category: "bug",
+    role: "Senior QA Engineer and Software Developer",
+    perspective: "You are investigating and fixing a bug report.",
+    focus: [
+      "Root cause analysis",
+      "Steps to reproduce",
+      "Impact assessment",
+      "Fix implementation",
+      "Regression prevention",
+      "Test cases to prevent recurrence"
+    ],
+    outputSuggestions: [
+      "Bug triage summary",
+      "Root cause explanation",
+      "Fix implementation plan",
+      "Test cases"
+    ]
+  },
+  feature: {
+    category: "feature",
+    role: "Product Engineer",
+    perspective: "You are implementing a new feature or enhancement.",
+    focus: [
+      "User requirements",
+      "Technical specification",
+      "Implementation approach",
+      "Edge cases",
+      "Acceptance criteria",
+      "Integration points"
+    ],
+    outputSuggestions: [
+      "Technical specification",
+      "Implementation tasks",
+      "Acceptance criteria checklist",
+      "API design"
+    ]
+  },
+  design: {
+    category: "design",
+    role: "UX Designer and Frontend Developer",
+    perspective: "You are designing and implementing a user interface.",
+    focus: [
+      "User experience flow",
+      "Visual design consistency",
+      "Accessibility (WCAG)",
+      "Responsive behavior",
+      "Component architecture",
+      "Interaction patterns"
+    ],
+    outputSuggestions: [
+      "User flow diagram",
+      "Component specifications",
+      "Accessibility checklist",
+      "Responsive breakpoints"
+    ]
+  },
+  review: {
+    category: "review",
+    role: "Code Reviewer and Technical Lead",
+    perspective: "You are reviewing code for quality, correctness, and maintainability.",
+    focus: [
+      "Code correctness",
+      "Performance implications",
+      "Security considerations",
+      "Testing coverage",
+      "Documentation",
+      "Best practices adherence"
+    ],
+    outputSuggestions: [
+      "Review checklist",
+      "Suggested improvements",
+      "Test scenarios",
+      "Security audit"
+    ]
+  },
+  onboarding: {
+    category: "onboarding",
+    role: "Technical Writer and Developer Advocate",
+    perspective: "You are creating documentation or onboarding materials.",
+    focus: [
+      "Clear step-by-step instructions",
+      "Prerequisites and setup",
+      "Common pitfalls",
+      "Examples and use cases",
+      "Troubleshooting guide",
+      "Related resources"
+    ],
+    outputSuggestions: [
+      "Getting started guide",
+      "Step-by-step tutorial",
+      "FAQ section",
+      "Troubleshooting guide"
+    ]
+  },
+  epic: {
+    category: "epic",
+    role: "Technical Project Manager and Architect",
+    perspective: "You are planning and coordinating a large initiative.",
+    focus: [
+      "Scope definition",
+      "Task breakdown",
+      "Dependencies",
+      "Risk assessment",
+      "Timeline considerations",
+      "Success metrics"
+    ],
+    outputSuggestions: [
+      "Epic breakdown into stories",
+      "Dependency graph",
+      "Risk mitigation plan",
+      "Success criteria"
+    ]
+  },
+  custom: {
+    category: "custom",
+    role: "Software Engineer",
+    perspective: "You are working on a software task.",
+    focus: [
+      "Understanding requirements",
+      "Implementation approach",
+      "Quality considerations",
+      "Testing strategy"
+    ],
+    outputSuggestions: [
+      "Implementation plan",
+      "Technical notes",
+      "Task checklist"
+    ]
+  }
+};
+var VARIANT_INSTRUCTIONS = {
+  analysis: `ANALYSIS MODE: Analyze this task thoroughly. Identify requirements, constraints, edge cases, and potential challenges. Do NOT implement anything yet - focus on understanding and planning.`,
+  draft: `DRAFT MODE: Create a detailed implementation plan with code structure, key decisions, and approach. Include pseudocode or skeleton code where helpful. This is for review before full implementation.`,
+  execute: `EXECUTE MODE: Implement this task completely. Write production-ready code following best practices. Include necessary tests and documentation.`
+};
+function inferCategoryFromLabels(labels) {
+  for (const label of labels) {
+    const normalizedName = label.name.toLowerCase().trim();
+    if (LABEL_CATEGORY_MAP[normalizedName]) {
+      return LABEL_CATEGORY_MAP[normalizedName];
+    }
+    for (const [key, category] of Object.entries(LABEL_CATEGORY_MAP)) {
+      if (normalizedName.includes(key) || key.includes(normalizedName)) {
+        return category;
+      }
+    }
+  }
+  return "custom";
+}
+function getRoleFraming(category) {
+  return DEFAULT_ROLE_FRAMINGS[category];
+}
+function estimateTokens(text) {
+  return Math.ceil(text.length / 4);
+}
+function formatSubtasks(subtasks) {
+  if (subtasks.length === 0)
+    return "";
+  const completed = subtasks.filter((s) => s.completed).length;
+  const lines = subtasks.map((s) => `  ${s.completed ? "[x]" : "[ ]"} ${s.title}`);
+  return `
+## Subtasks (${completed}/${subtasks.length} completed)
+${lines.join(`
+`)}`;
+}
+function formatLabels(labels) {
+  if (labels.length === 0)
+    return "";
+  return `
+**Labels:** ${labels.map((l) => l.name).join(", ")}`;
+}
+function formatLinkedCards(links) {
+  if (!links || links.length === 0)
+    return "";
+  const lines = links.map((link) => {
+    const prefix = link.direction === "outgoing" ? "->" : "<-";
+    return `  ${prefix} #${link.target_card.short_id}: ${link.target_card.title} (${link.display_type})`;
+  });
+  return `
+## Related Cards
+${lines.join(`
+`)}`;
+}
+function generatePrompt(options) {
+  const { card, column, variant, customConstraints } = options;
+  const contextOpts = {
+    includeTitle: true,
+    includeDescription: true,
+    includeLabels: true,
+    includeSubtasks: true,
+    includeActivity: false,
+    includeAssignee: true,
+    includeDueDate: true,
+    includePriority: true,
+    includeLinks: true,
+    includeColumn: true,
+    ...options.contextOptions
+  };
+  const labels = card.labels || [];
+  const subtasks = card.subtasks || [];
+  const links = card.links || [];
+  const category = inferCategoryFromLabels(labels);
+  const roleFraming = getRoleFraming(category);
+  const sections = [];
+  sections.push(`# Role: ${roleFraming.role}
+`);
+  sections.push(roleFraming.perspective);
+  sections.push("");
+  sections.push(VARIANT_INSTRUCTIONS[variant]);
+  sections.push("");
+  sections.push(`# Task: ${card.title}`);
+  if (contextOpts.includeColumn && column) {
+    sections.push(`**Status:** ${column.name}`);
+  }
+  if (contextOpts.includePriority) {
+    sections.push(`**Priority:** ${card.priority}`);
+  }
+  if (contextOpts.includeDueDate && card.due_date) {
+    sections.push(`**Due:** ${card.due_date}`);
+  }
+  if (contextOpts.includeAssignee && card.assignee) {
+    sections.push(`**Assignee:** ${card.assignee.full_name || card.assignee.email}`);
+  }
+  if (contextOpts.includeLabels && labels.length > 0) {
+    sections.push(formatLabels(labels));
+  }
+  if (contextOpts.includeDescription && card.description) {
+    sections.push(`
+## Description
+${card.description}`);
+  }
+  if (contextOpts.includeSubtasks && subtasks.length > 0) {
+    sections.push(formatSubtasks(subtasks));
+  }
+  if (contextOpts.includeLinks && links.length > 0) {
+    sections.push(formatLinkedCards(links));
+  }
+  sections.push(`
+## Focus Areas`);
+  roleFraming.focus.forEach((f) => {
+    sections.push(`- ${f}`);
+  });
+  sections.push(`
+## Suggested Outputs`);
+  roleFraming.outputSuggestions.forEach((s) => {
+    sections.push(`- ${s}`);
+  });
+  if (customConstraints) {
+    sections.push(`
+## Additional Instructions
+${customConstraints}`);
+  }
+  sections.push(`
+---
+*Card #${card.short_id} | Generated for ${variant} mode*`);
+  const prompt = sections.join(`
+`);
+  return {
+    prompt,
+    variant,
+    category,
+    role: roleFraming.role,
+    contextSummary: {
+      hasDescription: !!card.description,
+      labelCount: labels.length,
+      subtaskCount: subtasks.length,
+      completedSubtasks: subtasks.filter((s) => s.completed).length,
+      linkedCardCount: links.length
+    },
+    tokenEstimate: estimateTokens(prompt)
+  };
+}
+
 // src/server.ts
 var TOOLS = {
   harmony_create_card: {
@@ -23358,6 +23673,42 @@ var TOOLS = {
       required: ["cardId", "labelId"]
     }
   },
+  harmony_add_link_to_card: {
+    description: "Create a link between two cards. Link types: relates_to, blocks, duplicates, is_part_of",
+    inputSchema: {
+      type: "object",
+      properties: {
+        sourceCardId: { type: "string", description: "The card creating the link from" },
+        targetCardId: { type: "string", description: "The card being linked to" },
+        linkType: {
+          type: "string",
+          enum: ["relates_to", "blocks", "duplicates", "is_part_of"],
+          description: "Type of relationship: relates_to (generic), blocks (source blocks target), duplicates (source duplicates target), is_part_of (source is part of target)"
+        }
+      },
+      required: ["sourceCardId", "targetCardId", "linkType"]
+    }
+  },
+  harmony_remove_link_from_card: {
+    description: "Remove a link between cards",
+    inputSchema: {
+      type: "object",
+      properties: {
+        linkId: { type: "string", description: "The link ID to remove" }
+      },
+      required: ["linkId"]
+    }
+  },
+  harmony_get_card_links: {
+    description: "Get all links for a card",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: { type: "string", description: "Card ID to get links for" }
+      },
+      required: ["cardId"]
+    }
+  },
   harmony_create_subtask: {
     description: "Create a subtask on a card",
     inputSchema: {
@@ -23521,6 +23872,27 @@ var TOOLS = {
       },
       required: ["cardId"]
     }
+  },
+  harmony_generate_prompt: {
+    description: "Generate an AI-ready prompt from a card. Automatically infers role and focus based on labels (bug, feature, design, etc.). Use this to create context-rich prompts for working on cards.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: { type: "string", description: "Card ID (UUID) to generate prompt from" },
+        shortId: { type: "number", description: "Card short ID (e.g., 42 for #42) - alternative to cardId" },
+        projectId: { type: "string", description: "Project ID (required if using shortId, optional if context set)" },
+        variant: {
+          type: "string",
+          enum: ["analysis", "draft", "execute"],
+          description: "Prompt variant: analysis (understand/plan), draft (design solution), execute (implement fully). Default: execute"
+        },
+        includeSubtasks: { type: "boolean", description: "Include subtasks in prompt (default: true)" },
+        includeLinks: { type: "boolean", description: "Include linked cards in prompt (default: true)" },
+        includeDescription: { type: "boolean", description: "Include description in prompt (default: true)" },
+        customConstraints: { type: "string", description: "Additional instructions to append to the prompt" }
+      },
+      required: []
+    }
   }
 };
 var RESOURCES = [
@@ -23763,6 +24135,23 @@ Include: cards moved recently, current in-progress items, blocked or high-priori
         await client2.removeLabelFromCard(cardId, labelId);
         return { success: true };
       }
+      case "harmony_add_link_to_card": {
+        const sourceCardId = exports_external.string().uuid().parse(args.sourceCardId);
+        const targetCardId = exports_external.string().uuid().parse(args.targetCardId);
+        const linkType = exports_external.enum(["relates_to", "blocks", "duplicates", "is_part_of"]).parse(args.linkType);
+        const result = await client2.addLinkToCard(sourceCardId, targetCardId, linkType);
+        return { success: true, ...result };
+      }
+      case "harmony_remove_link_from_card": {
+        const linkId = exports_external.string().uuid().parse(args.linkId);
+        await client2.removeLinkFromCard(linkId);
+        return { success: true };
+      }
+      case "harmony_get_card_links": {
+        const cardId = exports_external.string().uuid().parse(args.cardId);
+        const result = await client2.getCardLinks(cardId);
+        return result;
+      }
       case "harmony_create_subtask": {
         const cardId = exports_external.string().uuid().parse(args.cardId);
         const title = exports_external.string().min(1).parse(args.title);
@@ -23880,6 +24269,61 @@ Include: cards moved recently, current in-progress items, blocked or high-priori
         });
         return { success: true, ...result };
       }
+      case "harmony_generate_prompt": {
+        let cardData;
+        let columnData = null;
+        if (args.cardId) {
+          const cardId = exports_external.string().uuid().parse(args.cardId);
+          const cardResult = await client2.getCard(cardId);
+          cardData = cardResult.card;
+        } else if (args.shortId !== undefined) {
+          const shortId = exports_external.number().int().positive().parse(args.shortId);
+          const projectId = args.projectId || getActiveProjectId();
+          if (!projectId) {
+            throw new Error("Project ID required when using shortId. Use harmony_set_project_context or provide projectId.");
+          }
+          const cardResult = await client2.getCardByShortId(projectId, shortId);
+          cardData = cardResult.card;
+        } else {
+          throw new Error("Either cardId or shortId must be provided");
+        }
+        const projectIdForBoard = args.projectId || getActiveProjectId() || cardData.project_id;
+        if (projectIdForBoard) {
+          try {
+            const board = await client2.getBoard(projectIdForBoard, { summary: true });
+            const columnId = cardData.column_id;
+            const column = board.columns.find((col) => col.id === columnId);
+            if (column) {
+              columnData = { name: column.name };
+            }
+          } catch {}
+        }
+        const variant = args.variant || "execute";
+        const contextOptions = {};
+        if (args.includeSubtasks !== undefined) {
+          contextOptions.includeSubtasks = args.includeSubtasks === true || args.includeSubtasks === "true";
+        }
+        if (args.includeLinks !== undefined) {
+          contextOptions.includeLinks = args.includeLinks === true || args.includeLinks === "true";
+        }
+        if (args.includeDescription !== undefined) {
+          contextOptions.includeDescription = args.includeDescription === true || args.includeDescription === "true";
+        }
+        const result = generatePrompt({
+          card: cardData,
+          column: columnData,
+          variant,
+          contextOptions,
+          customConstraints: args.customConstraints
+        });
+        return {
+          success: true,
+          cardId: cardData.id,
+          shortId: cardData.short_id,
+          title: cardData.title,
+          ...result
+        };
+      }
       default:
         throw new Error(`Unknown tool: ${name}`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harmony-mcp",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "MCP server for Harmony Kanban board - enables AI coding agents to manage your boards",
   "type": "module",
   "main": "dist/index.js",
@@ -13,11 +13,11 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/nicholasgriffintn/harmony.git"
+    "url": "https://github.com/Way/getharmony/tree/main/packages/mcp-server"
   },
   "homepage": "https://gethmy.com",
   "bugs": {
-    "url": "https://github.com/nicholasgriffintn/harmony/issues"
+    "url": "https://github.com/Way/getharmony/issues"
   },
   "keywords": [
     "mcp",