harmony-mcp 1.6.0 → 1.6.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harmony-mcp",
-  "version": "1.6.0",
+  "version": "1.6.2",
   "description": "MCP server for Harmony Kanban board - enables AI coding agents to manage your boards",
   "type": "module",
   "main": "dist/index.js",

package/dist/init.js

@@ -1,624 +0,0 @@
-import { createRequire } from "node:module";
-var __create = Object.create;
-var __getProtoOf = Object.getPrototypeOf;
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __toESM = (mod, isNodeMode, target) => {
-  target = mod != null ? __create(__getProtoOf(mod)) : {};
-  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
-  for (let key of __getOwnPropNames(mod))
-    if (!__hasOwnProp.call(to, key))
-      __defProp(to, key, {
-        get: () => mod[key],
-        enumerable: true
-      });
-  return to;
-};
-var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: (newValue) => all[name] = () => newValue
-    });
-};
-var __require = /* @__PURE__ */ createRequire(import.meta.url);
-
-// src/init.ts
-import { existsSync, mkdirSync, writeFileSync, readFileSync, symlinkSync, unlinkSync, lstatSync } from "node:fs";
-import { join, dirname } from "node:path";
-import { homedir } from "node:os";
-var HARMONY_WORKFLOW_PROMPT = `# Harmony Card Workflow
-
-Start work on a Harmony card. Card reference: $ARGUMENTS
-
-## 1. Find & Fetch Card
-
-Parse the reference and fetch the card:
-- \`#42\` or \`42\` → \`harmony_get_card_by_short_id\` with \`shortId: 42\`
-- UUID → \`harmony_get_card\` with \`cardId\`
-- Name/text → \`harmony_search_cards\` with \`query\`
-
-## 2. Get Board State
-
-Call \`harmony_get_board\` to get columns and labels. From the response:
-- Find the "In Progress" (or "Progress") column ID
-- Find the "agent" label ID
-
-## 3. Setup Card for Work
-
-Execute these in sequence:
-1. \`harmony_move_card\` → Move to "In Progress" column
-2. \`harmony_add_label_to_card\` → Add "agent" label
-3. \`harmony_start_agent_session\`:
-   - \`cardId\`: Card UUID
-   - \`agentIdentifier\`: Your agent identifier
-   - \`agentName\`: Your agent name
-   - \`currentTask\`: "Analyzing card requirements"
-
-## 4. Generate Work Prompt
-
-Call \`harmony_generate_prompt\` with:
-- \`cardId\` or \`shortId\` (+ \`projectId\` if using shortId)
-- \`variant\`: Select based on task:
-  - \`"execute"\` (default) → Clear tasks, bug fixes, well-defined work
-  - \`"analysis"\` → Complex features, unclear requirements
-  - \`"draft"\` → Medium complexity, want feedback first
-
-The generated prompt provides role framing, focus areas, subtasks, linked cards, and suggested outputs.
-
-## 5. Display Card Summary
-
-Show the user: Card title, short ID, role, priority, labels, due date, description, and subtasks.
-
-## 6. Implement Solution
-
-Work on the card following the generated prompt's guidance. Update progress at milestones:
-- \`harmony_update_agent_progress\` with \`progressPercent\` (0-100), \`currentTask\`, \`status\`, \`blockers\`
-
-**Progress checkpoints:** 20% (exploration), 50% (implementation), 80% (testing), 100% (done)
-
-## 7. Complete Work
-
-When finished:
-1. \`harmony_end_agent_session\` with \`status: "completed"\`, \`progressPercent: 100\`
-2. \`harmony_move_card\` to "Review" column
-3. Summarize accomplishments
-
-If pausing: \`harmony_end_agent_session\` with \`status: "paused"\`
-
-## Key Tools Reference
-
-**Cards:** \`harmony_get_card\`, \`harmony_get_card_by_short_id\`, \`harmony_search_cards\`, \`harmony_create_card\`, \`harmony_update_card\`, \`harmony_move_card\`, \`harmony_delete_card\`, \`harmony_assign_card\`
-
-**Subtasks:** \`harmony_create_subtask\`, \`harmony_toggle_subtask\`, \`harmony_delete_subtask\`
-
-**Labels:** \`harmony_add_label_to_card\`, \`harmony_remove_label_from_card\`, \`harmony_create_label\`
-
-**Links:** \`harmony_add_link_to_card\`, \`harmony_remove_link_from_card\`, \`harmony_get_card_links\`
-
-**Board:** \`harmony_get_board\`, \`harmony_list_projects\`, \`harmony_get_context\`, \`harmony_set_project_context\`
-
-**Sessions:** \`harmony_start_agent_session\`, \`harmony_update_agent_progress\`, \`harmony_end_agent_session\`, \`harmony_get_agent_session\`
-
-**AI:** \`harmony_generate_prompt\`, \`harmony_process_command\`
-`;
-var HARMONY_STANDUP_PROMPT = `# Harmony Daily Standup
-
-Generate a daily standup summary for the current project.
-
-## 1. Get Board State
-
-Call \`harmony_get_board\` to get the full board state including:
-- All columns and their cards
-- Card priorities, assignees, and due dates
-- Active agent sessions
-
-## 2. Analyze Board
-
-Organize the information into standup categories:
-
-### What was completed recently
-- Cards in "Done" or "Review" columns
-- Cards with recent activity (moved, updated)
-
-### What's in progress
-- Cards in "In Progress" column
-- Cards with active agent sessions (show progress %)
-- Who's working on what
-
-### What's blocked or at risk
-- High-priority cards not in progress
-- Overdue cards
-- Cards with blockers
-
-### What's coming up
-- Cards in "To Do" column
-- Upcoming due dates
-
-## 3. Present Summary
-
-Format the summary as a clean, readable standup report:
-- Use bullet points for easy scanning
-- Highlight priorities and blockers
-- Include card short IDs for easy reference (e.g., #42)
-- Note any agent work in progress
-`;
-var HARMONY_CLEANUP_PROMPT = `# Harmony Board Cleanup
-
-Analyze the board and suggest cleanup actions.
-
-## 1. Get Board State
-
-Call \`harmony_get_board\` to get the full board state.
-
-## 2. Identify Issues
-
-Look for:
-
-### Stale cards
-- Cards in "In Progress" for too long without updates
-- Cards with past due dates
-- Cards with no recent activity
-
-### Organizational issues
-- Cards missing priorities
-- Cards missing assignees in active columns
-- Empty descriptions on complex cards
-
-### Potential duplicates
-- Cards with similar titles
-- Use \`harmony_search_cards\` if needed to find related cards
-
-## 3. Suggest Actions
-
-For each issue found, suggest a specific action:
-- Move stale cards back to backlog
-- Archive completed cards
-- Update missing information
-- Merge or link duplicates
-
-Present suggestions as a prioritized list with:
-- Card reference (#ID)
-- Current state
-- Suggested action
-- Why it matters
-
-## 4. Optional: Execute Cleanup
-
-If the user approves, execute the suggested actions:
-- Use \`harmony_move_card\` to reorganize
-- Use \`harmony_update_card\` to add missing info
-- Use \`harmony_add_link_to_card\` to link related cards
-`;
-function ensureDir(dirPath) {
-  if (!existsSync(dirPath)) {
-    mkdirSync(dirPath, { recursive: true });
-  }
-}
-function writeFileIfNotExists(filePath, content, force) {
-  if (existsSync(filePath) && !force) {
-    return { created: false, skipped: true };
-  }
-  ensureDir(dirname(filePath));
-  writeFileSync(filePath, content, "utf-8");
-  return { created: true, skipped: false };
-}
-var GLOBAL_SKILLS_DIR = join(homedir(), ".agents", "skills");
-function pathExists(filePath) {
-  try {
-    lstatSync(filePath);
-    return true;
-  } catch {
-    return false;
-  }
-}
-function createSymlink(target, linkPath, force) {
-  if (pathExists(linkPath)) {
-    if (!force) {
-      return { created: false, skipped: true };
-    }
-    try {
-      unlinkSync(linkPath);
-    } catch {}
-  }
-  ensureDir(dirname(linkPath));
-  symlinkSync(target, linkPath);
-  return { created: true, skipped: false };
-}
-function mergeJsonFile(filePath, updates, force) {
-  if (!existsSync(filePath)) {
-    ensureDir(dirname(filePath));
-    writeFileSync(filePath, JSON.stringify(updates, null, 2), "utf-8");
-    return { created: true, skipped: false, merged: false };
-  }
-  try {
-    const existing = JSON.parse(readFileSync(filePath, "utf-8"));
-    if (updates.mcpServers && existing.mcpServers) {
-      if (existing.mcpServers.harmony && !force) {
-        return { created: false, skipped: true, merged: false };
-      }
-      existing.mcpServers = { ...existing.mcpServers, ...updates.mcpServers };
-    } else {
-      Object.assign(existing, updates);
-    }
-    writeFileSync(filePath, JSON.stringify(existing, null, 2), "utf-8");
-    return { created: false, skipped: false, merged: true };
-  } catch {
-    if (force) {
-      writeFileSync(filePath, JSON.stringify(updates, null, 2), "utf-8");
-      return { created: true, skipped: false, merged: false };
-    }
-    return { created: false, skipped: true, merged: false };
-  }
-}
-function initClaude(cwd, force, installMode) {
-  const result = {
-    agent: "claude",
-    filesCreated: [],
-    filesSkipped: [],
-    symlinksCreated: []
-  };
-  const skillContent = `---
-name: hmy
-description: Start working on a Harmony card. Use when given a card reference like #42, UUID, or card name to implement.
-argument-hint: <card-reference>
----
-
-${HARMONY_WORKFLOW_PROMPT.replace("Your agent identifier", "claude-code").replace("Your agent name", "Claude Code")}
-`;
-  const standupContent = `---
-name: hmy-standup
-description: Generate a daily standup summary. Use when asked for project status, daily update, or standup report.
----
-
-${HARMONY_STANDUP_PROMPT}
-`;
-  const cleanupContent = `---
-name: hmy-cleanup
-description: Analyze board for stale cards and suggest cleanup. Use when asked to clean up, audit, or organize the board.
----
-
-${HARMONY_CLEANUP_PROMPT}
-`;
-  if (installMode === "global") {
-    const skills = [
-      { name: "hmy", content: skillContent },
-      { name: "hmy-standup", content: standupContent },
-      { name: "hmy-cleanup", content: cleanupContent }
-    ];
-    for (const skill of skills) {
-      const centralPath = join(GLOBAL_SKILLS_DIR, skill.name, "SKILL.md");
-      const { created, skipped } = writeFileIfNotExists(centralPath, skill.content, force);
-      if (created)
-        result.filesCreated.push(centralPath);
-      if (skipped)
-        result.filesSkipped.push(centralPath);
-      const symlinkPath = join(homedir(), ".claude", "skills", skill.name);
-      const symlinkTarget = join(GLOBAL_SKILLS_DIR, skill.name);
-      const symlinkResult = createSymlink(symlinkTarget, symlinkPath, force);
-      if (symlinkResult.created)
-        result.symlinksCreated.push(`${symlinkPath} → ${symlinkTarget}`);
-      if (symlinkResult.skipped)
-        result.filesSkipped.push(symlinkPath);
-    }
-  } else {
-    const skillPath = join(cwd, ".claude", "skills", "hmy", "SKILL.md");
-    const { created, skipped } = writeFileIfNotExists(skillPath, skillContent, force);
-    if (created)
-      result.filesCreated.push(skillPath);
-    if (skipped)
-      result.filesSkipped.push(skillPath);
-    const standupPath = join(cwd, ".claude", "skills", "hmy-standup", "SKILL.md");
-    const standupResult = writeFileIfNotExists(standupPath, standupContent, force);
-    if (standupResult.created)
-      result.filesCreated.push(standupPath);
-    if (standupResult.skipped)
-      result.filesSkipped.push(standupPath);
-    const cleanupPath = join(cwd, ".claude", "skills", "hmy-cleanup", "SKILL.md");
-    const cleanupResult = writeFileIfNotExists(cleanupPath, cleanupContent, force);
-    if (cleanupResult.created)
-      result.filesCreated.push(cleanupPath);
-    if (cleanupResult.skipped)
-      result.filesSkipped.push(cleanupPath);
-  }
-  const globalConfigPath = join(homedir(), ".claude", "settings.json");
-  const mcpConfig = {
-    mcpServers: {
-      harmony: {
-        command: "harmony-mcp",
-        args: ["serve"]
-      }
-    }
-  };
-  const configResult = mergeJsonFile(globalConfigPath, mcpConfig, force);
-  if (configResult.created || configResult.merged) {
-    result.filesCreated.push(globalConfigPath);
-  } else if (configResult.skipped) {
-    result.filesSkipped.push(globalConfigPath);
-  }
-  return result;
-}
-function initCodex(cwd, force, installMode) {
-  const result = {
-    agent: "codex",
-    filesCreated: [],
-    filesSkipped: [],
-    symlinksCreated: []
-  };
-  const agentsContent = `# Harmony Integration
-
-This project uses Harmony for task management. When working on tasks:
-
-## Starting Work on a Card
-
-When given a card reference (e.g., #42 or a card name), follow this workflow:
-
-1. Use \`harmony_get_card_by_short_id\` or \`harmony_search_cards\` to find the card
-2. Move the card to "In Progress" using \`harmony_move_card\`
-3. Add the "agent" label using \`harmony_add_label_to_card\`
-4. Start a session with \`harmony_start_agent_session\` (agentIdentifier: "codex", agentName: "OpenAI Codex")
-5. Show the card details to the user
-6. Use \`harmony_generate_prompt\` to get guidance, then implement the solution
-7. Update progress periodically with \`harmony_update_agent_progress\`
-8. When done, call \`harmony_end_agent_session\` and move to "Review"
-
-## Available Harmony Tools
-
-- \`harmony_get_card\`, \`harmony_get_card_by_short_id\`, \`harmony_search_cards\` - Find cards
-- \`harmony_move_card\` - Move cards between columns
-- \`harmony_add_label_to_card\`, \`harmony_remove_label_from_card\` - Manage labels
-- \`harmony_start_agent_session\`, \`harmony_update_agent_progress\`, \`harmony_end_agent_session\` - Track work
-- \`harmony_get_board\` - Get board state
-- \`harmony_generate_prompt\` - Get role-based guidance and focus areas for the card
-`;
-  const promptContent = `---
-name: hmy
-description: Start working on a Harmony card
-arguments:
-  - name: card
-    description: Card reference (#42, UUID, or name)
-    required: true
----
-
-${HARMONY_WORKFLOW_PROMPT.replace("$ARGUMENTS", "{{card}}").replace("Your agent identifier", "codex").replace("Your agent name", "OpenAI Codex")}
-`;
-  if (installMode === "global") {
-    const centralPromptPath = join(GLOBAL_SKILLS_DIR, "codex", "hmy.md");
-    const { created, skipped } = writeFileIfNotExists(centralPromptPath, promptContent, force);
-    if (created)
-      result.filesCreated.push(centralPromptPath);
-    if (skipped)
-      result.filesSkipped.push(centralPromptPath);
-    const symlinkPath = join(homedir(), ".codex", "prompts", "hmy.md");
-    const symlinkResult = createSymlink(centralPromptPath, symlinkPath, force);
-    if (symlinkResult.created)
-      result.symlinksCreated.push(`${symlinkPath} → ${centralPromptPath}`);
-    if (symlinkResult.skipped)
-      result.filesSkipped.push(symlinkPath);
-  } else {
-    const promptPath = join(homedir(), ".codex", "prompts", "hmy.md");
-    const { created, skipped } = writeFileIfNotExists(promptPath, promptContent, force);
-    if (created)
-      result.filesCreated.push(promptPath);
-    if (skipped)
-      result.filesSkipped.push(promptPath);
-  }
-  const agentsPath = join(cwd, "AGENTS.md");
-  const { created: agentsCreated, skipped: agentsSkipped } = writeFileIfNotExists(agentsPath, agentsContent, force);
-  if (agentsCreated)
-    result.filesCreated.push(agentsPath);
-  if (agentsSkipped)
-    result.filesSkipped.push(agentsPath);
-  const configPath = join(homedir(), ".codex", "config.toml");
-  const mcpConfigSection = `
-# Harmony MCP Server
-[mcp_servers.harmony]
-command = "harmony-mcp"
-args = ["serve"]
-`;
-  if (!existsSync(configPath)) {
-    ensureDir(dirname(configPath));
-    writeFileSync(configPath, mcpConfigSection, "utf-8");
-    result.filesCreated.push(configPath);
-  } else {
-    const existingConfig = readFileSync(configPath, "utf-8");
-    if (!existingConfig.includes("[mcp_servers.harmony]")) {
-      writeFileSync(configPath, existingConfig + `
-` + mcpConfigSection, "utf-8");
-      result.filesCreated.push(configPath);
-    } else if (force) {
-      const updated = existingConfig.replace(/\[mcp_servers\.harmony\][\s\S]*?(?=\[|$)/, mcpConfigSection.trim() + `
-
-`);
-      writeFileSync(configPath, updated, "utf-8");
-      result.filesCreated.push(configPath);
-    } else {
-      result.filesSkipped.push(configPath);
-    }
-  }
-  return result;
-}
-function initCursor(cwd, force, installMode) {
-  const result = {
-    agent: "cursor",
-    filesCreated: [],
-    filesSkipped: [],
-    symlinksCreated: []
-  };
-  const ruleContent = `---
-description: Harmony card workflow rule
-globs:
-  - "**/*"
-alwaysApply: false
----
-
-# Harmony Integration
-
-When the user asks you to work on a Harmony card (references like #42, card names, or UUIDs):
-
-${HARMONY_WORKFLOW_PROMPT.replace("$ARGUMENTS", "the card reference").replace("Your agent identifier", "cursor").replace("Your agent name", "Cursor AI")}
-`;
-  const mcpConfigPath = join(cwd, ".cursor", "mcp.json");
-  const mcpConfig = {
-    mcpServers: {
-      harmony: {
-        command: "harmony-mcp",
-        args: ["serve"]
-      }
-    }
-  };
-  const mcpResult = mergeJsonFile(mcpConfigPath, mcpConfig, force);
-  if (mcpResult.created || mcpResult.merged) {
-    result.filesCreated.push(mcpConfigPath);
-  } else if (mcpResult.skipped) {
-    result.filesSkipped.push(mcpConfigPath);
-  }
-  if (installMode === "global") {
-    const centralRulePath = join(GLOBAL_SKILLS_DIR, "cursor", "harmony.mdc");
-    const { created, skipped } = writeFileIfNotExists(centralRulePath, ruleContent, force);
-    if (created)
-      result.filesCreated.push(centralRulePath);
-    if (skipped)
-      result.filesSkipped.push(centralRulePath);
-    const symlinkPath = join(homedir(), ".cursor", "rules", "harmony.mdc");
-    const symlinkResult = createSymlink(centralRulePath, symlinkPath, force);
-    if (symlinkResult.created)
-      result.symlinksCreated.push(`${symlinkPath} → ${centralRulePath}`);
-    if (symlinkResult.skipped)
-      result.filesSkipped.push(symlinkPath);
-  } else {
-    const rulePath = join(cwd, ".cursor", "rules", "harmony.mdc");
-    const { created, skipped } = writeFileIfNotExists(rulePath, ruleContent, force);
-    if (created)
-      result.filesCreated.push(rulePath);
-    if (skipped)
-      result.filesSkipped.push(rulePath);
-  }
-  return result;
-}
-function initWindsurf(cwd, force, installMode) {
-  const result = {
-    agent: "windsurf",
-    filesCreated: [],
-    filesSkipped: [],
-    symlinksCreated: []
-  };
-  const ruleContent = `---
-trigger: model_decision
-description: Activate when user asks to work on a Harmony card (references like #42, card names, or task management)
----
-
-# Harmony Card Workflow
-
-When working on a Harmony card:
-
-${HARMONY_WORKFLOW_PROMPT.replace("$ARGUMENTS", "the card reference").replace("Your agent identifier", "windsurf").replace("Your agent name", "Windsurf AI")}
-`;
-  const globalMcpPath = join(homedir(), ".codeium", "windsurf", "mcp_config.json");
-  const mcpConfig = {
-    mcpServers: {
-      harmony: {
-        command: "harmony-mcp",
-        args: ["serve"],
-        disabled: false,
-        alwaysAllow: []
-      }
-    }
-  };
-  const mcpResult = mergeJsonFile(globalMcpPath, mcpConfig, force);
-  if (mcpResult.created || mcpResult.merged) {
-    result.filesCreated.push(globalMcpPath);
-  } else if (mcpResult.skipped) {
-    result.filesSkipped.push(globalMcpPath);
-  }
-  if (installMode === "global") {
-    const centralRulePath = join(GLOBAL_SKILLS_DIR, "windsurf", "harmony.md");
-    const { created, skipped } = writeFileIfNotExists(centralRulePath, ruleContent, force);
-    if (created)
-      result.filesCreated.push(centralRulePath);
-    if (skipped)
-      result.filesSkipped.push(centralRulePath);
-    const symlinkPath = join(homedir(), ".codeium", "windsurf", "rules", "harmony.md");
-    const symlinkResult = createSymlink(centralRulePath, symlinkPath, force);
-    if (symlinkResult.created)
-      result.symlinksCreated.push(`${symlinkPath} → ${centralRulePath}`);
-    if (symlinkResult.skipped)
-      result.filesSkipped.push(symlinkPath);
-  } else {
-    const rulePath = join(cwd, ".windsurf", "rules", "harmony.md");
-    const { created, skipped } = writeFileIfNotExists(rulePath, ruleContent, force);
-    if (created)
-      result.filesCreated.push(rulePath);
-    if (skipped)
-      result.filesSkipped.push(rulePath);
-  }
-  return result;
-}
-function initHarmony(options = {}) {
-  const cwd = options.cwd || process.cwd();
-  const force = options.force || false;
-  const agents = options.agents || ["claude", "codex", "cursor", "windsurf"];
-  const installMode = options.installMode || "local";
-  const results = [];
-  for (const agent of agents) {
-    try {
-      switch (agent) {
-        case "claude":
-          results.push(initClaude(cwd, force, installMode));
-          break;
-        case "codex":
-          results.push(initCodex(cwd, force, installMode));
-          break;
-        case "cursor":
-          results.push(initCursor(cwd, force, installMode));
-          break;
-        case "windsurf":
-          results.push(initWindsurf(cwd, force, installMode));
-          break;
-        default:
-          results.push({
-            agent,
-            filesCreated: [],
-            filesSkipped: [],
-            symlinksCreated: [],
-            error: `Unknown agent: ${agent}`
-          });
-      }
-    } catch (error) {
-      results.push({
-        agent,
-        filesCreated: [],
-        filesSkipped: [],
-        symlinksCreated: [],
-        error: error instanceof Error ? error.message : String(error)
-      });
-    }
-  }
-  return results;
-}
-function detectAgents(cwd = process.cwd()) {
-  const detected = [];
-  if (existsSync(join(cwd, ".claude")) || existsSync(join(homedir(), ".claude"))) {
-    detected.push("claude");
-  }
-  if (existsSync(join(cwd, "AGENTS.md")) || existsSync(join(homedir(), ".codex"))) {
-    detected.push("codex");
-  }
-  if (existsSync(join(cwd, ".cursor"))) {
-    detected.push("cursor");
-  }
-  if (existsSync(join(cwd, ".windsurf")) || existsSync(join(cwd, ".windsurfrules")) || existsSync(join(homedir(), ".codeium", "windsurf"))) {
-    detected.push("windsurf");
-  }
-  return detected;
-}
-var SUPPORTED_AGENTS = ["claude", "codex", "cursor", "windsurf"];
-export {
-  initHarmony,
-  detectAgents,
-  SUPPORTED_AGENTS
-};