harmony-mcp 1.3.2 → 1.5.0

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
@@ -106,6 +106,94 @@ If pausing: \`harmony_end_agent_session\` with \`status: "paused"\`
 
 **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 });
@@ -119,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));
@@ -145,25 +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 = `---
+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: {
@@ -181,11 +342,12 @@ ${HARMONY_WORKFLOW_PROMPT.replace("Your agent identifier", "claude-code").replac
   }
   return result;
 }
-function initCodex(cwd, force) {
+function initCodex(cwd, force, installMode) {
   const result = {
     agent: "codex",
     filesCreated: [],
-    filesSkipped: []
+    filesSkipped: [],
+    symlinksCreated: []
   };
   const agentsContent = `# Harmony Integration
 
@@ -213,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
@@ -230,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
@@ -266,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: {
@@ -287,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: {
@@ -331,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}`
           });
       }
@@ -383,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.2",
+  "version": "1.5.0",
   "description": "MCP server for Harmony Kanban board - enables AI coding agents to manage your boards",
   "type": "module",
   "main": "dist/index.js",
@@ -37,20 +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": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "commander": "^12.0.0",
-    "hono": "^4.0.0",
-    "zod": "^3.23.0"
+    "@clack/prompts": "^0.11.0",
+    "@modelcontextprotocol/sdk": "^1.25.3",
+    "commander": "^14.0.2",
+    "hono": "^4.11.5",
+    "picocolors": "^1.1.1",
+    "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@types/node": "^22.0.0",
-    "typescript": "^5.6.0"
+    "@types/node": "^25.0.10",
+    "typescript": "^5.9.3"
   }
 }