harmony-mcp 1.3.3 → 1.5.1

package/dist/init.js

@@ -28,7 +28,7 @@ var __export = (target, all) => {
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // src/init.ts
-import { existsSync, mkdirSync, writeFileSync, readFileSync } from "node:fs";
+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
@@ -207,6 +207,28 @@ function writeFileIfNotExists(filePath, content, force) {
   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));
@@ -233,49 +255,76 @@ function mergeJsonFile(filePath, updates, force) {
     return { created: false, skipped: true, merged: false };
   }
 }
-function initClaude(cwd, force) {
+function initClaude(cwd, force, installMode) {
   const result = {
     agent: "claude",
     filesCreated: [],
-    filesSkipped: []
+    filesSkipped: [],
+    symlinksCreated: []
   };
-  const commandContent = `---
-description: Start working on a Harmony card (moves to In Progress, adds agent label)
+  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 commandPath = join(cwd, ".claude", "commands", "hmy.md");
-  const { created, skipped } = writeFileIfNotExists(commandPath, commandContent, force);
-  if (created)
-    result.filesCreated.push(commandPath);
-  if (skipped)
-    result.filesSkipped.push(commandPath);
   const standupContent = `---
-description: Generate a daily standup summary for the current Harmony project
+name: hmy-standup
+description: Generate a daily standup summary. Use when asked for project status, daily update, or standup report.
 ---
 
 ${HARMONY_STANDUP_PROMPT}
 `;
-  const standupPath = join(cwd, ".claude", "commands", "hmy-standup.md");
-  const standupResult = writeFileIfNotExists(standupPath, standupContent, force);
-  if (standupResult.created)
-    result.filesCreated.push(standupPath);
-  if (standupResult.skipped)
-    result.filesSkipped.push(standupPath);
   const cleanupContent = `---
-description: Analyze the Harmony board and suggest cleanup actions for stale cards
+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}
 `;
-  const cleanupPath = join(cwd, ".claude", "commands", "hmy-cleanup.md");
-  const cleanupResult = writeFileIfNotExists(cleanupPath, cleanupContent, force);
-  if (cleanupResult.created)
-    result.filesCreated.push(cleanupPath);
-  if (cleanupResult.skipped)
-    result.filesSkipped.push(cleanupPath);
+  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: {
@@ -293,11 +342,12 @@ ${HARMONY_CLEANUP_PROMPT}
   }
   return result;
 }
-function initCodex(cwd, force) {
+function initCodex(cwd, force, installMode) {
   const result = {
     agent: "codex",
     filesCreated: [],
-    filesSkipped: []
+    filesSkipped: [],
+    symlinksCreated: []
   };
   const agentsContent = `# Harmony Integration
 
@@ -325,12 +375,6 @@ When given a card reference (e.g., #42 or a card name), follow this workflow:
 - \`harmony_get_board\` - Get board state
 - \`harmony_generate_prompt\` - Get role-based guidance and focus areas for the card
 `;
-  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 promptContent = `---
 name: hmy
 description: Start working on a Harmony card
@@ -342,13 +386,33 @@ arguments:
 
 ${HARMONY_WORKFLOW_PROMPT.replace("$ARGUMENTS", "{{card}}").replace("Your agent identifier", "codex").replace("Your agent name", "OpenAI Codex")}
 `;
-  const promptsDir = join(homedir(), ".codex", "prompts");
-  const promptPath = join(promptsDir, "hmy.md");
-  const { created: promptCreated, skipped: promptSkipped } = writeFileIfNotExists(promptPath, promptContent, force);
-  if (promptCreated)
-    result.filesCreated.push(promptPath);
-  if (promptSkipped)
-    result.filesSkipped.push(promptPath);
+  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
@@ -378,12 +442,26 @@ args = ["serve"]
   }
   return result;
 }
-function initCursor(cwd, force) {
+function initCursor(cwd, force, installMode) {
   const result = {
     agent: "cursor",
     filesCreated: [],
-    filesSkipped: []
+    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: {
@@ -399,33 +477,47 @@ function initCursor(cwd, force) {
   } else if (mcpResult.skipped) {
     result.filesSkipped.push(mcpConfigPath);
   }
-  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 rulePath = join(cwd, ".cursor", "rules", "harmony.mdc");
-  const { created: ruleCreated, skipped: ruleSkipped } = writeFileIfNotExists(rulePath, ruleContent, force);
-  if (ruleCreated)
-    result.filesCreated.push(rulePath);
-  if (ruleSkipped)
-    result.filesSkipped.push(rulePath);
+  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) {
+function initWindsurf(cwd, force, installMode) {
   const result = {
     agent: "windsurf",
     filesCreated: [],
-    filesSkipped: []
+    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: {
@@ -443,50 +535,56 @@ function initWindsurf(cwd, force) {
   } else if (mcpResult.skipped) {
     result.filesSkipped.push(globalMcpPath);
   }
-  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 rulePath = join(cwd, ".windsurf", "rules", "harmony.md");
-  const { created: ruleCreated, skipped: ruleSkipped } = writeFileIfNotExists(rulePath, ruleContent, force);
-  if (ruleCreated)
-    result.filesCreated.push(rulePath);
-  if (ruleSkipped)
-    result.filesSkipped.push(rulePath);
+  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));
+          results.push(initClaude(cwd, force, installMode));
           break;
         case "codex":
-          results.push(initCodex(cwd, force));
+          results.push(initCodex(cwd, force, installMode));
           break;
         case "cursor":
-          results.push(initCursor(cwd, force));
+          results.push(initCursor(cwd, force, installMode));
           break;
         case "windsurf":
-          results.push(initWindsurf(cwd, force));
+          results.push(initWindsurf(cwd, force, installMode));
           break;
         default:
           results.push({
             agent,
             filesCreated: [],
             filesSkipped: [],
+            symlinksCreated: [],
             error: `Unknown agent: ${agent}`
           });
       }
@@ -495,6 +593,7 @@ function initHarmony(options = {}) {
         agent,
         filesCreated: [],
         filesSkipped: [],
+        symlinksCreated: [],
         error: error instanceof Error ? error.message : String(error)
       });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harmony-mcp",
-  "version": "1.3.3",
+  "version": "1.5.1",
   "description": "MCP server for Harmony Kanban board - enables AI coding agents to manage your boards",
   "type": "module",
   "main": "dist/index.js",
@@ -37,22 +37,22 @@
     "node": ">=18.0.0"
   },
   "scripts": {
-    "build": "bun build src/index.ts src/cli.ts src/init.ts --outdir dist --target node",
-    "build:bun": "bun build src/index.ts src/http.ts src/cli.ts src/init.ts --outdir dist --target bun",
+    "build": "bun build src/index.ts src/cli.ts --outdir dist --target node",
+    "build:bun": "bun build src/index.ts src/http.ts src/cli.ts --outdir dist --target bun",
     "dev": "bun --watch src/index.ts",
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@clack/prompts": "^0.9.1",
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "commander": "^12.0.0",
-    "hono": "^4.0.0",
+    "@clack/prompts": "^0.11.0",
+    "@modelcontextprotocol/sdk": "^1.25.3",
+    "commander": "^14.0.2",
+    "hono": "^4.11.5",
     "picocolors": "^1.1.1",
-    "zod": "^3.23.0"
+    "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@types/node": "^22.0.0",
-    "typescript": "^5.6.0"
+    "@types/node": "^25.0.10",
+    "typescript": "^5.9.3"
   }
 }