@gethmy/mcp 2.8.0 → 2.8.2

package/dist/cli.js

@@ -1121,6 +1121,87 @@ function getDisplayLinkType(linkType, direction) {
     return linkType;
   return LINK_TYPE_INVERSES[linkType];
 }
+// ../harmony-shared/dist/commentSerializer.js
+var CONFLICT_INSTRUCTION = "When two comments conflict, prefer the latest created_at, UNLESS a later " + "comment explicitly confirms or restates the earlier finding. Evaluate " + "substance, not just recency. Cite the comment id(s) you relied on.";
+function authorLabel(c) {
+  if (c.author_type === "agent")
+    return "AI agent";
+  return c.author?.full_name || c.author?.email || "teammate";
+}
+function criticalIds(comments) {
+  const keep = new Set;
+  for (const c of comments) {
+    if (c.comment_type === "decision")
+      keep.add(c.id);
+    if (c.supersedes_id) {
+      keep.add(c.id);
+      keep.add(c.supersedes_id);
+    }
+    if (c.confirms_id) {
+      keep.add(c.id);
+      keep.add(c.confirms_id);
+    }
+  }
+  return keep;
+}
+function serializeCommentThread(comments, options = {}) {
+  const { heading = "Conversation", includeInstructions = true, activity = [], maxComments } = options;
+  const visible = comments.filter((c) => !c.deleted_at).slice().sort((a, b) => a.created_at.localeCompare(b.created_at));
+  if (visible.length === 0)
+    return "";
+  const indexById = new Map;
+  visible.forEach((c, i) => {
+    indexById.set(c.id, i + 1);
+  });
+  let rendered = visible;
+  let elidedCount = 0;
+  if (maxComments && visible.length > maxComments) {
+    const keep = criticalIds(visible);
+    const recentThreshold = visible.length - maxComments;
+    rendered = visible.filter((c, i) => i >= recentThreshold || keep.has(c.id));
+    elidedCount = visible.length - rendered.length;
+  }
+  const ref = (id) => {
+    const n = indexById.get(id);
+    return n ? `#${n}` : `#${id.slice(0, 8)}`;
+  };
+  const lines = [];
+  if (elidedCount > 0) {
+    lines.push({
+      at: visible[0]?.created_at ?? "",
+      text: `(${elidedCount} earlier comment(s) omitted for brevity)`
+    });
+  }
+  for (const c of rendered) {
+    const tags = [];
+    if (c.edited_at)
+      tags.push("edited");
+    if (c.supersedes_id)
+      tags.push(`supersedes ${ref(c.supersedes_id)}`);
+    if (c.confirms_id)
+      tags.push(`confirms ${ref(c.confirms_id)}`);
+    if (c.resolved_at)
+      tags.push("resolved");
+    const tagStr = tags.length ? ` | ${tags.join(" | ")}` : "";
+    const header = `[${ref(c.id)} | ${c.author_type} | ${authorLabel(c)} | ${c.comment_type} | ${c.created_at}${tagStr}]`;
+    lines.push({ at: c.created_at, text: `${header}
+${c.body.trim()}` });
+  }
+  for (const a of activity) {
+    const actor = a.actor ? `${a.actor} ` : "";
+    lines.push({ at: a.at, text: `· (system) ${a.at} — ${actor}${a.text}` });
+  }
+  lines.sort((a, b) => a.at.localeCompare(b.at));
+  const body = lines.map((l) => l.text).join(`
+
+`);
+  const instruction = includeInstructions ? `
+
+${CONFLICT_INSTRUCTION}` : "";
+  return `## ${heading} (oldest → newest)
+
+${body}${instruction}`;
+}
 // ../harmony-shared/dist/constants.js
 var TIMINGS = {
   SEARCH_DEBOUNCE: 300,
@@ -1473,6 +1554,28 @@ class HarmonyApiClient {
   async deleteSubtask(subtaskId) {
     return this.request("DELETE", `/subtasks/${subtaskId}`);
   }
+  async addComment(cardId, body, opts) {
+    return this.request("POST", `/cards/${cardId}/comments`, {
+      body,
+      authorType: "agent",
+      commentType: opts?.commentType,
+      supersedesId: opts?.supersedesId,
+      confirmsId: opts?.confirmsId,
+      agentSessionId: opts?.agentSessionId
+    });
+  }
+  async getComments(cardId, opts) {
+    const qs = new URLSearchParams;
+    if (opts?.limit != null)
+      qs.set("limit", String(opts.limit));
+    if (opts?.offset != null)
+      qs.set("offset", String(opts.offset));
+    const suffix = qs.toString() ? `?${qs.toString()}` : "";
+    return this.request("GET", `/cards/${cardId}/comments${suffix}`);
+  }
+  async updateComment(commentId, updates) {
+    return this.request("PATCH", `/comments/${commentId}`, updates);
+  }
   async startAgentSession(cardId, data) {
     return this.request("POST", `/cards/${cardId}/agent-context`, data);
   }
@@ -1830,6 +1933,24 @@ class HarmonyApiClient {
       assembledContext: assembledContextStr,
       assemblyId
     });
+    try {
+      const { comments } = await this.getComments(options.cardId, {
+        limit: 200
+      });
+      if (Array.isArray(comments) && comments.length > 0) {
+        const section = serializeCommentThread(comments, {
+          heading: "Comments",
+          maxComments: 40
+        });
+        if (section)
+          result.prompt = `${result.prompt}
+
+${section}`;
+      }
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.debug(`[generateCardPrompt] comments fetch failed: ${msg}`);
+    }
     try {
       await this.recordPromptHistory({
         cardId: cardData.id,
@@ -2378,6 +2499,294 @@ async function onboardNewUser(params) {
   };
 }
 
+// src/skills.ts
+import {
+  existsSync as existsSync4,
+  mkdirSync as mkdirSync3,
+  readFileSync as readFileSync4,
+  renameSync,
+  writeFileSync as writeFileSync3
+} from "node:fs";
+import { homedir as homedir3 } from "node:os";
+import { dirname, join as join4 } from "node:path";
+
+// src/hmy-config.ts
+import { existsSync as existsSync3, readFileSync as readFileSync3 } from "node:fs";
+import { homedir as homedir2 } from "node:os";
+import { join as join3 } from "node:path";
+var DEFAULTS = { updateCheck: true, pin: null };
+function getHmyConfigPath() {
+  return join3(homedir2(), ".hmy", "config.yaml");
+}
+function loadHmyConfig() {
+  const path = getHmyConfigPath();
+  if (!existsSync3(path))
+    return { ...DEFAULTS };
+  try {
+    return parseHmyConfig(readFileSync3(path, "utf-8"));
+  } catch {
+    return { ...DEFAULTS };
+  }
+}
+function parseHmyConfig(text) {
+  const cfg = { ...DEFAULTS };
+  for (const rawLine of text.split(`
+`)) {
+    const line = rawLine.trim();
+    if (!line || line.startsWith("#"))
+      continue;
+    const sep2 = line.indexOf(":");
+    if (sep2 === -1)
+      continue;
+    const key = line.slice(0, sep2).trim();
+    let value = line.slice(sep2 + 1).trim();
+    const hash = value.indexOf(" #");
+    if (hash !== -1)
+      value = value.slice(0, hash).trim();
+    value = value.replace(/^["']|["']$/g, "");
+    switch (key) {
+      case "update_check":
+        cfg.updateCheck = value !== "false";
+        break;
+      case "pin":
+      case "pin_version":
+        cfg.pin = value || null;
+        break;
+    }
+  }
+  return cfg;
+}
+
+// src/skills.ts
+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\`
+`;
+function buildSkillFile(skill) {
+  const content = stripSkillPreamble(skill.content);
+  if (skill.skillVersion !== undefined && !hasMetadataVersion(content)) {
+    return injectMetadataVersion(content, skill.skillVersion);
+  }
+  return content;
+}
+var PREAMBLE_START = "<!-- hmy-skills-preamble:start -->";
+var PREAMBLE_END = "<!-- hmy-skills-preamble:end -->";
+function stripSkillPreamble(content) {
+  const start = content.indexOf(PREAMBLE_START);
+  const end = content.indexOf(PREAMBLE_END);
+  if (start === -1 || end === -1 || end < start)
+    return content;
+  const stripped = content.slice(0, start) + content.slice(end + PREAMBLE_END.length);
+  return `${stripped.replace(/\n{3,}/g, `
+
+`).replace(/\s+$/, "")}
+`;
+}
+function atomicWrite(filePath, content) {
+  const dir = dirname(filePath);
+  if (!existsSync4(dir))
+    mkdirSync3(dir, { recursive: true });
+  const tmp = `${filePath}.tmp-${process.pid}-${Date.now()}`;
+  writeFileSync3(tmp, content);
+  renameSync(tmp, filePath);
+}
+function hasMetadataVersion(content) {
+  return parseSkillVersion(content) !== null;
+}
+function injectMetadataVersion(content, version) {
+  const fmMatch = content.match(/^(---\n[\s\S]*?\n)(---\n)([\s\S]*)$/);
+  if (!fmMatch)
+    return content;
+  const [, head, close, body] = fmMatch;
+  const block = `metadata:
+  version: "${version}"
+`;
+  return `${head}${block}${close}${body}`;
+}
+function parseSkillVersion(content) {
+  const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+  if (fmMatch) {
+    const fm = fmMatch[1];
+    const verMatch = fm.match(/^metadata:[\s\S]*?\n[ \t]+version:[ \t]*["']?(\d+)["']?\s*$/m);
+    if (verMatch)
+      return verMatch[1];
+  }
+  const legacy = content.match(/<!-- skills-version:(\d+) -->/);
+  return legacy ? legacy[1] : null;
+}
+function findSkillFiles(paths, knownNames) {
+  const results = [];
+  for (const filePath of paths) {
+    if (!existsSync4(filePath))
+      continue;
+    for (const name of knownNames) {
+      if (filePath.includes(`/${name}/`) || filePath.includes(`/${name}.md`)) {
+        results.push({ name, filePath });
+        break;
+      }
+    }
+  }
+  return results;
+}
+var HMY_DIR = join4(homedir3(), ".hmy");
+var HMY_VERSION_FILE = join4(HMY_DIR, "VERSION");
+var LAST_CHECK_FILE = join4(HMY_DIR, "last-update-check");
+var CHECK_TTL_MS = 24 * 60 * 60 * 1000;
+function checkedRecently(now = Date.now()) {
+  try {
+    if (!existsSync4(LAST_CHECK_FILE))
+      return false;
+    const ts = Number.parseInt(readFileSync4(LAST_CHECK_FILE, "utf-8").trim(), 10);
+    if (!Number.isFinite(ts))
+      return false;
+    return now - ts < CHECK_TTL_MS;
+  } catch {
+    return false;
+  }
+}
+function recordCheck(now = Date.now()) {
+  try {
+    if (!existsSync4(HMY_DIR))
+      mkdirSync3(HMY_DIR, { recursive: true });
+    writeFileSync3(LAST_CHECK_FILE, String(now));
+  } catch {}
+}
+async function refreshSkills(opts = {}) {
+  try {
+    if (!isConfigured())
+      return { updated: false };
+    const cfg = loadHmyConfig();
+    if (!cfg.updateCheck || cfg.pin)
+      return { updated: false };
+    if (!opts.force && checkedRecently())
+      return { updated: false };
+    const status = areSkillsInstalled();
+    if (!status.installed)
+      return { updated: false };
+    const client3 = new HarmonyApiClient;
+    const versionInfo = await client3.fetchSkillsVersion();
+    recordCheck();
+    const skillFiles = findSkillFiles(status.paths, versionInfo.skills);
+    if (skillFiles.length > 0) {
+      const samplePath = skillFiles[0].filePath;
+      for (const name of versionInfo.skills) {
+        if (skillFiles.some((sf) => sf.name === name))
+          continue;
+        let siblingPath;
+        if (samplePath.endsWith("SKILL.md")) {
+          const parentDir = dirname(dirname(samplePath));
+          siblingPath = `${parentDir}/${name}/SKILL.md`;
+        } else {
+          const parentDir = dirname(samplePath);
+          siblingPath = `${parentDir}/${name}.md`;
+        }
+        if (existsSync4(siblingPath)) {
+          skillFiles.push({ name, filePath: siblingPath });
+        }
+      }
+    }
+    if (skillFiles.length === 0)
+      return { updated: false };
+    let updated = false;
+    for (const { name, filePath } of skillFiles) {
+      try {
+        const currentContent = readFileSync4(filePath, "utf-8");
+        const localVersion = parseSkillVersion(currentContent);
+        const fetched = await client3.fetchSkill(name);
+        const remoteVersion = fetched.skillVersion;
+        if (remoteVersion !== undefined && localVersion !== null && Number(localVersion) >= remoteVersion) {
+          continue;
+        }
+        atomicWrite(filePath, buildSkillFile(fetched));
+        updated = true;
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`Harmony: skill "${name}" refresh failed: ${msg}`);
+      }
+    }
+    if (updated) {
+      try {
+        atomicWrite(HMY_VERSION_FILE, versionInfo.version);
+      } catch {}
+      console.error("Harmony: Refreshed skills from server");
+    }
+    return { updated };
+  } catch {
+    return { updated: false };
+  }
+}
+
 // src/server.ts
 var memorySessions = new Map;
 function parseLabelList(raw) {
@@ -2515,7 +2924,11 @@ var TOOLS = {
           enum: ["low", "medium", "high", "urgent"],
           description: "Priority level"
         },
-        assigneeId: { type: "string", description: "Assignee user ID" }
+        assigneeId: { type: "string", description: "Assignee user ID" },
+        planId: {
+          type: "string",
+          description: "Plan ID to link this card to (optional). Links the card to that plan via its plan_id."
+        }
       },
       required: ["title"]
     }
@@ -2840,6 +3253,66 @@ var TOOLS = {
       required: ["subtaskId"]
     }
   },
+  harmony_add_comment: {
+    description: "Post a comment on a card as the agent. Use this to converse with the human in the open: report progress, ask a question, record a decision, or note a finding — instead of editing the card description. Set supersedesId to correct an earlier comment, confirmsId to reaffirm one. When the thread conflicts, prefer the latest comment unless a later one confirms an earlier finding; cite the comment id(s) you relied on.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: { type: "string", description: "Card UUID to comment on" },
+        body: { type: "string", description: "Comment body (Markdown)" },
+        commentType: {
+          type: "string",
+          enum: [
+            "message",
+            "progress",
+            "question",
+            "blocker",
+            "decision",
+            "summary",
+            "finding"
+          ],
+          description: "Type of comment. 'question'/'blocker' signal you need a human; default 'message'."
+        },
+        supersedesId: {
+          type: "string",
+          description: "Comment id this comment corrects/updates"
+        },
+        confirmsId: {
+          type: "string",
+          description: "Comment id this comment reaffirms"
+        }
+      },
+      required: ["cardId", "body"]
+    }
+  },
+  harmony_get_comments: {
+    description: "Get the comment thread on a card (oldest → newest). Returns human + agent comments with author, type, edited/resolved state, and supersede/confirm links. Read this before acting so you weigh later comments over earlier ones they contradict.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        cardId: { type: "string" },
+        limit: { type: "number" },
+        offset: { type: "number" }
+      },
+      required: ["cardId"]
+    }
+  },
+  harmony_update_comment: {
+    description: "Update one of your own comments: edit the body, pin it, or resolve a question/blocker once it has been answered.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        commentId: { type: "string" },
+        body: { type: "string" },
+        pinned: { type: "boolean" },
+        resolve: {
+          type: "boolean",
+          description: "Mark (true) or clear (false) the resolved state"
+        }
+      },
+      required: ["commentId"]
+    }
+  },
   harmony_list_workspaces: {
     description: "List all workspaces the user has access to",
     inputSchema: {
@@ -3830,7 +4303,7 @@ function registerHandlers(server, deps) {
           {
             uri,
             mimeType: "text/markdown",
-            text: fetched.content
+            text: stripSkillPreamble(fetched.content)
           }
         ]
       };
@@ -3880,7 +4353,8 @@ async function handleToolCall(name, args, deps) {
         columnId: args.columnId,
         description: args.description,
         priority: args.priority,
-        assigneeId: args.assigneeId
+        assigneeId: args.assigneeId,
+        planId: args.planId
       });
       return { success: true, ...result };
     }
@@ -4100,6 +4574,49 @@ async function handleToolCall(name, args, deps) {
       await client3.deleteSubtask(subtaskId);
       return { success: true };
     }
+    case "harmony_add_comment": {
+      const cardId = z.string().uuid().parse(args.cardId);
+      const body = z.string().min(1).max(1e4).parse(args.body);
+      const commentType = args.commentType !== undefined ? z.enum([
+        "message",
+        "progress",
+        "question",
+        "blocker",
+        "decision",
+        "summary",
+        "finding"
+      ]).parse(args.commentType) : undefined;
+      const supersedesId = args.supersedesId !== undefined ? z.string().uuid().parse(args.supersedesId) : undefined;
+      const confirmsId = args.confirmsId !== undefined ? z.string().uuid().parse(args.confirmsId) : undefined;
+      const result = await client3.addComment(cardId, body, {
+        commentType,
+        supersedesId,
+        confirmsId
+      });
+      return { success: true, ...result };
+    }
+    case "harmony_get_comments": {
+      const cardId = z.string().uuid().parse(args.cardId);
+      const limit = args.limit !== undefined ? z.number().int().min(1).max(500).parse(args.limit) : undefined;
+      const offset = args.offset !== undefined ? z.number().int().min(0).parse(args.offset) : undefined;
+      const result = await client3.getComments(cardId, { limit, offset });
+      return { success: true, ...result };
+    }
+    case "harmony_update_comment": {
+      const commentId = z.string().uuid().parse(args.commentId);
+      const updates = {};
+      if (args.body !== undefined) {
+        updates.body = z.string().min(1).max(1e4).parse(args.body);
+      }
+      if (args.pinned !== undefined) {
+        updates.pinned = z.boolean().parse(args.pinned);
+      }
+      if (args.resolve !== undefined) {
+        updates.resolve = z.boolean().parse(args.resolve);
+      }
+      const result = await client3.updateComment(commentId, updates);
+      return { success: true, ...result };
+    }
     case "harmony_list_workspaces": {
       const result = await client3.listWorkspaces();
       return { success: true, ...result };
@@ -4906,13 +5423,16 @@ function createConfigDeps() {
 class HarmonyMCPServer {
   server;
   constructor() {
-    this.server = new Server({ name: "@gethmy/mcp", version: "2.0.0" }, { capabilities: { tools: {}, resources: {} } });
+    this.server = new Server({ name: "@gethmy/mcp", version: "2.0.0" }, { capabilities: { tools: {}, resources: { listChanged: true } } });
     registerHandlers(this.server, createConfigDeps());
   }
-  async run() {
+  async run(opts = {}) {
     const transport = new StdioServerTransport;
     await this.server.connect(transport);
     console.error("Harmony MCP server running on stdio");
+    if (opts.skillsUpdated) {
+      this.server.sendResourceListChanged().catch(() => {});
+    }
     const configDeps = createConfigDeps();
     initAutoSession(async (client3, cardId, status) => {
       await runEndSessionPipeline(client3, configDeps, cardId, status);
@@ -4959,209 +5479,30 @@ class HarmonyMCPServer {
   }
 }
 
-// src/skills.ts
-import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "node:fs";
-import { dirname } from "node:path";
-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\`
-`;
-function buildSkillFile(skill) {
-  if (skill.skillVersion !== undefined && !hasMetadataVersion(skill.content)) {
-    return injectMetadataVersion(skill.content, skill.skillVersion);
-  }
-  return skill.content;
-}
-function hasMetadataVersion(content) {
-  return parseSkillVersion(content) !== null;
-}
-function injectMetadataVersion(content, version) {
-  const fmMatch = content.match(/^(---\n[\s\S]*?\n)(---\n)([\s\S]*)$/);
-  if (!fmMatch)
-    return content;
-  const [, head, close, body] = fmMatch;
-  const block = `metadata:
-  version: "${version}"
-`;
-  return `${head}${block}${close}${body}`;
-}
-function parseSkillVersion(content) {
-  const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
-  if (fmMatch) {
-    const fm = fmMatch[1];
-    const verMatch = fm.match(/^metadata:[\s\S]*?\n[ \t]+version:[ \t]*["']?(\d+)["']?\s*$/m);
-    if (verMatch)
-      return verMatch[1];
-  }
-  const legacy = content.match(/<!-- skills-version:(\d+) -->/);
-  return legacy ? legacy[1] : null;
-}
-function findSkillFiles(paths, knownNames) {
-  const results = [];
-  for (const filePath of paths) {
-    if (!existsSync3(filePath))
-      continue;
-    for (const name of knownNames) {
-      if (filePath.includes(`/${name}/`) || filePath.includes(`/${name}.md`)) {
-        results.push({ name, filePath });
-        break;
-      }
-    }
-  }
-  return results;
-}
-async function refreshSkills() {
-  try {
-    if (!isConfigured())
-      return;
-    const status = areSkillsInstalled();
-    if (!status.installed)
-      return;
-    const client3 = new HarmonyApiClient;
-    const versionInfo = await client3.fetchSkillsVersion();
-    const skillFiles = findSkillFiles(status.paths, versionInfo.skills);
-    if (skillFiles.length > 0) {
-      const samplePath = skillFiles[0].filePath;
-      for (const name of versionInfo.skills) {
-        if (skillFiles.some((sf) => sf.name === name))
-          continue;
-        let siblingPath;
-        if (samplePath.endsWith("SKILL.md")) {
-          const parentDir = dirname(dirname(samplePath));
-          siblingPath = `${parentDir}/${name}/SKILL.md`;
-        } else {
-          const parentDir = dirname(samplePath);
-          siblingPath = `${parentDir}/${name}.md`;
-        }
-        if (existsSync3(siblingPath)) {
-          skillFiles.push({ name, filePath: siblingPath });
-        }
-      }
-    }
-    if (skillFiles.length === 0)
-      return;
-    let updated = false;
-    for (const { name, filePath } of skillFiles) {
-      try {
-        const currentContent = readFileSync3(filePath, "utf-8");
-        const localVersion = parseSkillVersion(currentContent);
-        const fetched = await client3.fetchSkill(name);
-        const remoteVersion = fetched.skillVersion;
-        if (remoteVersion !== undefined && localVersion !== null && Number(localVersion) >= remoteVersion) {
-          continue;
-        }
-        const newContent = buildSkillFile(fetched);
-        const dir = dirname(filePath);
-        if (!existsSync3(dir))
-          mkdirSync3(dir, { recursive: true });
-        writeFileSync3(filePath, newContent);
-        updated = true;
-      } catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        console.error(`Harmony: skill "${name}" refresh failed: ${msg}`);
-      }
-    }
-    if (updated) {
-      console.error("Harmony: Refreshed skills from server");
-    }
-  } catch {}
-}
-
 // src/tui/setup.ts
 import { createHash as createHash3 } from "node:crypto";
 import {
-  existsSync as existsSync7,
+  existsSync as existsSync8,
   lstatSync,
   mkdirSync as mkdirSync5,
   symlinkSync,
   unlinkSync
 } from "node:fs";
-import { homedir as homedir4 } from "node:os";
-import { dirname as dirname3, join as join5 } from "node:path";
+import { homedir as homedir6 } from "node:os";
+import { dirname as dirname3, join as join7 } from "node:path";
 import * as p3 from "@clack/prompts";
 
 // src/tui/agents.ts
-import { existsSync as existsSync4 } from "node:fs";
-import { homedir as homedir2 } from "node:os";
-import { join as join3 } from "node:path";
+import { existsSync as existsSync5 } from "node:fs";
+import { homedir as homedir4 } from "node:os";
+import { join as join5 } from "node:path";
 var AGENT_DEFINITIONS = [
   {
     id: "claude",
     name: "Claude Code",
     description: "Anthropic CLI agent",
     hint: "/hmy <card>",
-    globalPaths: [join3(homedir2(), ".claude")],
+    globalPaths: [join5(homedir4(), ".claude")],
     localPaths: [".claude"]
   },
   {
@@ -5169,7 +5510,7 @@ var AGENT_DEFINITIONS = [
     name: "Codex",
     description: "OpenAI coding agent",
     hint: "/prompts:hmy <card>",
-    globalPaths: [join3(homedir2(), ".codex")],
+    globalPaths: [join5(homedir4(), ".codex")],
     localPaths: ["AGENTS.md"]
   },
   {
@@ -5185,20 +5526,20 @@ var AGENT_DEFINITIONS = [
     name: "Windsurf",
     description: "Codeium AI IDE",
     hint: "MCP tools available automatically",
-    globalPaths: [join3(homedir2(), ".codeium", "windsurf")],
+    globalPaths: [join5(homedir4(), ".codeium", "windsurf")],
     localPaths: [".windsurf", ".windsurfrules"]
   }
 ];
 function detectAgents(cwd = process.cwd()) {
   return AGENT_DEFINITIONS.map((def) => {
-    const globalPath = def.globalPaths.find((p) => existsSync4(p)) || null;
-    const localPath = def.localPaths.find((p) => existsSync4(join3(cwd, p))) || null;
+    const globalPath = def.globalPaths.find((p) => existsSync5(p)) || null;
+    const localPath = def.localPaths.find((p) => existsSync5(join5(cwd, p))) || null;
     return {
       id: def.id,
       name: def.name,
       detected: !!(globalPath || localPath),
       globalPath,
-      localPath: localPath ? join3(cwd, localPath) : null,
+      localPath: localPath ? join5(cwd, localPath) : null,
       description: def.description,
       hint: def.hint
     };
@@ -5206,8 +5547,8 @@ function detectAgents(cwd = process.cwd()) {
 }
 
 // src/tui/docs.ts
-import { existsSync as existsSync5, readdirSync as readdirSync2, readFileSync as readFileSync4, statSync } from "node:fs";
-import { isAbsolute, join as join4, resolve, sep as sep2 } from "node:path";
+import { existsSync as existsSync6, readdirSync as readdirSync2, readFileSync as readFileSync5, statSync } from "node:fs";
+import { isAbsolute, join as join6, resolve, sep as sep2 } from "node:path";
 import * as p from "@clack/prompts";
 
 // src/tui/theme.ts
@@ -5294,14 +5635,14 @@ var IGNORED_DIRS = new Set([
 ]);
 function readJson(filePath) {
   try {
-    return JSON.parse(readFileSync4(filePath, "utf-8"));
+    return JSON.parse(readFileSync5(filePath, "utf-8"));
   } catch {
     return null;
   }
 }
 function readText(filePath) {
   try {
-    return readFileSync4(filePath, "utf-8");
+    return readFileSync5(filePath, "utf-8");
   } catch {
     return null;
   }
@@ -5312,7 +5653,7 @@ function listDirs(dirPath) {
       if (IGNORED_DIRS.has(entry) || entry.startsWith("."))
         return false;
       try {
-        return statSync(join4(dirPath, entry)).isDirectory();
+        return statSync(join6(dirPath, entry)).isDirectory();
       } catch {
         return false;
       }
@@ -5360,25 +5701,25 @@ function describeDir(name) {
 }
 function scanProject(cwd) {
   let packageManager = null;
-  if (existsSync5(join4(cwd, "bun.lock")) || existsSync5(join4(cwd, "bun.lockb"))) {
+  if (existsSync6(join6(cwd, "bun.lock")) || existsSync6(join6(cwd, "bun.lockb"))) {
     packageManager = "bun";
-  } else if (existsSync5(join4(cwd, "pnpm-lock.yaml"))) {
+  } else if (existsSync6(join6(cwd, "pnpm-lock.yaml"))) {
     packageManager = "pnpm";
-  } else if (existsSync5(join4(cwd, "yarn.lock"))) {
+  } else if (existsSync6(join6(cwd, "yarn.lock"))) {
     packageManager = "yarn";
-  } else if (existsSync5(join4(cwd, "package.json"))) {
+  } else if (existsSync6(join6(cwd, "package.json"))) {
     packageManager = "npm";
   }
-  const pkg = readJson(join4(cwd, "package.json"));
+  const pkg = readJson(join6(cwd, "package.json"));
   const scripts = pkg && typeof pkg.scripts === "object" && pkg.scripts !== null ? pkg.scripts : {};
   let language = "unknown";
-  if (existsSync5(join4(cwd, "tsconfig.json"))) {
+  if (existsSync6(join6(cwd, "tsconfig.json"))) {
     language = "typescript";
-  } else if (existsSync5(join4(cwd, "go.mod"))) {
+  } else if (existsSync6(join6(cwd, "go.mod"))) {
     language = "go";
-  } else if (existsSync5(join4(cwd, "Cargo.toml"))) {
+  } else if (existsSync6(join6(cwd, "Cargo.toml"))) {
     language = "rust";
-  } else if (existsSync5(join4(cwd, "setup.py")) || existsSync5(join4(cwd, "pyproject.toml"))) {
+  } else if (existsSync6(join6(cwd, "setup.py")) || existsSync6(join6(cwd, "pyproject.toml"))) {
     language = "python";
   } else if (pkg) {
     language = "javascript";
@@ -5414,7 +5755,7 @@ function scanProject(cwd) {
     }
   }
   let linter = null;
-  if (existsSync5(join4(cwd, "biome.json")) || existsSync5(join4(cwd, "biome.jsonc"))) {
+  if (existsSync6(join6(cwd, "biome.json")) || existsSync6(join6(cwd, "biome.jsonc"))) {
     linter = "biome";
   } else {
     const eslintFiles = [
@@ -5429,7 +5770,7 @@ function scanProject(cwd) {
       "eslint.config.cjs",
       "eslint.config.ts"
     ];
-    if (eslintFiles.some((f) => existsSync5(join4(cwd, f)))) {
+    if (eslintFiles.some((f) => existsSync6(join6(cwd, f)))) {
       linter = "eslint";
     } else {
       const prettierFiles = [
@@ -5441,13 +5782,13 @@ function scanProject(cwd) {
         "prettier.config.js",
         "prettier.config.mjs"
       ];
-      if (prettierFiles.some((f) => existsSync5(join4(cwd, f)))) {
+      if (prettierFiles.some((f) => existsSync6(join6(cwd, f)))) {
         linter = "prettier";
       }
     }
   }
   let indentStyle = null;
-  const biome = readJson(join4(cwd, "biome.json")) ?? readJson(join4(cwd, "biome.jsonc"));
+  const biome = readJson(join6(cwd, "biome.json")) ?? readJson(join6(cwd, "biome.jsonc"));
   if (biome) {
     const formatter = biome.formatter;
     if (formatter) {
@@ -5457,7 +5798,7 @@ function scanProject(cwd) {
     }
   }
   if (!indentStyle) {
-    const editorConfig = readText(join4(cwd, ".editorconfig"));
+    const editorConfig = readText(join6(cwd, ".editorconfig"));
     if (editorConfig) {
       const styleMatch = editorConfig.match(/indent_style\s*=\s*(space|tab)/);
       const sizeMatch = editorConfig.match(/indent_size\s*=\s*(\d+)/);
@@ -5470,13 +5811,13 @@ function scanProject(cwd) {
     }
   }
   const dirs = listDirs(cwd);
-  const srcDirs = existsSync5(join4(cwd, "src")) ? listDirs(join4(cwd, "src")) : [];
-  const monorepo = existsSync5(join4(cwd, "packages")) || existsSync5(join4(cwd, "apps"));
+  const srcDirs = existsSync6(join6(cwd, "src")) ? listDirs(join6(cwd, "src")) : [];
+  const monorepo = existsSync6(join6(cwd, "packages")) || existsSync6(join6(cwd, "apps"));
   const existingDocs = {
-    agentsMd: existsSync5(join4(cwd, "AGENTS.md")),
-    claudeMd: existsSync5(join4(cwd, "CLAUDE.md")),
-    docsDir: existsSync5(join4(cwd, "docs")),
-    architectureMd: existsSync5(join4(cwd, "docs", "architecture.md"))
+    agentsMd: existsSync6(join6(cwd, "AGENTS.md")),
+    claudeMd: existsSync6(join6(cwd, "CLAUDE.md")),
+    docsDir: existsSync6(join6(cwd, "docs")),
+    architectureMd: existsSync6(join6(cwd, "docs", "architecture.md"))
   };
   return {
     packageManager,
@@ -5627,9 +5968,9 @@ var VAGUE_STANDARDS = [
 ];
 function verifyDocs(cwd) {
   const issues = [];
-  const claudeMd = readText(join4(cwd, "CLAUDE.md"));
-  const agentsMd = readText(join4(cwd, "AGENTS.md"));
-  const pkg = readJson(join4(cwd, "package.json"));
+  const claudeMd = readText(join6(cwd, "CLAUDE.md"));
+  const agentsMd = readText(join6(cwd, "AGENTS.md"));
+  const pkg = readJson(join6(cwd, "package.json"));
   const pkgScripts = pkg && typeof pkg.scripts === "object" && pkg.scripts !== null ? pkg.scripts : {};
   const projectRoot = resolve(cwd);
   if (claudeMd) {
@@ -5659,7 +6000,7 @@ function verifyDocs(cwd) {
           continue;
         }
         importedFiles.push({ ref: refPath, resolved: resolvedPath });
-        if (!existsSync5(resolvedPath)) {
+        if (!existsSync6(resolvedPath)) {
           issues.push({
             severity: "error",
             file: "CLAUDE.md",
@@ -5795,7 +6136,7 @@ function verifyDocs(cwd) {
     }
     checkBacktickPaths(agentsMd, "AGENTS.md", cwd, issues);
   }
-  const archMd = readText(join4(cwd, "docs", "architecture.md"));
+  const archMd = readText(join6(cwd, "docs", "architecture.md"));
   if (archMd) {
     checkBacktickPaths(archMd, "docs/architecture.md", cwd, issues);
   }
@@ -5842,7 +6183,7 @@ function checkBacktickPaths(content, file, cwd, issues) {
     const resolvedRef = resolve(root, refPath);
     if (resolvedRef !== root && !resolvedRef.startsWith(root + sep2))
       continue;
-    if (!existsSync5(resolvedRef)) {
+    if (!existsSync6(resolvedRef)) {
       issues.push({
         severity: "warning",
         file,
@@ -5865,18 +6206,18 @@ async function runDocsStep(cwd) {
     }
     const files = [];
     files.push({
-      path: join4(cwd, "AGENTS.md"),
+      path: join6(cwd, "AGENTS.md"),
       content: generateAgentsMd(info, cwd),
       type: "text"
     });
     files.push({
-      path: join4(cwd, "CLAUDE.md"),
+      path: join6(cwd, "CLAUDE.md"),
       content: generateClaudeMd(info),
       type: "text"
     });
     if (info.dirs.includes("docs") || info.srcDirs.length > 0) {
       files.push({
-        path: join4(cwd, "docs", "architecture.md"),
+        path: join6(cwd, "docs", "architecture.md"),
         content: generateArchitectureMd(info, cwd),
         type: "text"
       });
@@ -5914,21 +6255,21 @@ async function runDocsStep(cwd) {
 // src/tui/writer.ts
 import {
   chmodSync,
-  existsSync as existsSync6,
+  existsSync as existsSync7,
   mkdirSync as mkdirSync4,
-  readFileSync as readFileSync5,
+  readFileSync as readFileSync6,
   writeFileSync as writeFileSync4
 } from "node:fs";
-import { homedir as homedir3 } from "node:os";
+import { homedir as homedir5 } from "node:os";
 import { dirname as dirname2 } from "node:path";
 import * as p2 from "@clack/prompts";
 function ensureDir(dirPath) {
-  if (!existsSync6(dirPath)) {
+  if (!existsSync7(dirPath)) {
     mkdirSync4(dirPath, { recursive: true, mode: 493 });
   }
 }
 function writeFile(filePath, content, options = {}) {
-  const exists = existsSync6(filePath);
+  const exists = existsSync7(filePath);
   if (exists && !options.force) {
     return { path: filePath, action: "skip" };
   }
@@ -5950,7 +6291,7 @@ function writeFile(filePath, content, options = {}) {
   }
 }
 function mergeJsonFile(filePath, updates, options = {}) {
-  const exists = existsSync6(filePath);
+  const exists = existsSync7(filePath);
   if (!exists) {
     try {
       ensureDir(dirname2(filePath));
@@ -5967,7 +6308,7 @@ function mergeJsonFile(filePath, updates, options = {}) {
     }
   }
   try {
-    const existing = JSON.parse(readFileSync5(filePath, "utf-8"));
+    const existing = JSON.parse(readFileSync6(filePath, "utf-8"));
     if (updates.mcpServers && existing.mcpServers) {
       const existingServers = existing.mcpServers;
       const updateServers = updates.mcpServers;
@@ -6000,7 +6341,7 @@ function mergeJsonFile(filePath, updates, options = {}) {
   }
 }
 function appendToToml(filePath, section, content, options = {}) {
-  const exists = existsSync6(filePath);
+  const exists = existsSync7(filePath);
   if (!exists) {
     try {
       ensureDir(dirname2(filePath));
@@ -6015,7 +6356,7 @@ function appendToToml(filePath, section, content, options = {}) {
     }
   }
   try {
-    const existing = readFileSync5(filePath, "utf-8");
+    const existing = readFileSync6(filePath, "utf-8");
     if (existing.includes(section)) {
       if (options.force) {
         const updated = existing.replace(new RegExp(`\\[${section.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\][\\s\\S]*?(?=\\[|$)`), content.trim() + `
@@ -6039,7 +6380,7 @@ function appendToToml(filePath, section, content, options = {}) {
 }
 async function writeFilesWithProgress(files, options = {}) {
   const results = [];
-  const home = homedir3();
+  const home = homedir5();
   const spinner2 = p2.spinner();
   spinner2.start("Writing configuration files...");
   for (const file of files) {
@@ -6076,10 +6417,10 @@ function getWriteSummary(files, options = {}) {
   const toCreate = [];
   const toUpdate = [];
   const toSkip = [];
-  const home = homedir3();
+  const home = homedir5();
   for (const file of files) {
     const displayPath = formatPath(file.path, home);
-    const exists = existsSync6(file.path);
+    const exists = existsSync7(file.path);
     if (exists && !options.force) {
       toSkip.push(displayPath);
     } else if (exists) {
@@ -6092,7 +6433,7 @@ function getWriteSummary(files, options = {}) {
 }
 
 // src/tui/setup.ts
-var GLOBAL_SKILLS_DIR = join5(homedir4(), ".agents", "skills");
+var GLOBAL_SKILLS_DIR = join7(homedir6(), ".agents", "skills");
 var API_URL = "https://app.gethmy.com/api";
 async function registerMcpServer() {
   try {
@@ -6106,16 +6447,16 @@ async function registerMcpServer() {
   }
 }
 async function writeMcpConfigFallback(home) {
-  const { readFileSync: readFileSync6, writeFileSync: writeFileSync5, mkdirSync: mkdirSync6, existsSync: existsSync8 } = await import("node:fs");
-  const settingsPath = join5(home, ".claude", "settings.json");
+  const { readFileSync: readFileSync7, writeFileSync: writeFileSync5, mkdirSync: mkdirSync6, existsSync: existsSync9 } = await import("node:fs");
+  const settingsPath = join7(home, ".claude", "settings.json");
   const settingsDir = dirname3(settingsPath);
-  if (!existsSync8(settingsDir)) {
+  if (!existsSync9(settingsDir)) {
     mkdirSync6(settingsDir, { recursive: true });
   }
   let settings = {};
-  if (existsSync8(settingsPath)) {
+  if (existsSync9(settingsPath)) {
     try {
-      settings = JSON.parse(readFileSync6(settingsPath, "utf-8"));
+      settings = JSON.parse(readFileSync7(settingsPath, "utf-8"));
     } catch {}
   }
   const mcpServers = settings.mcpServers || {};
@@ -6206,7 +6547,7 @@ async function resolveProjectSlug(apiKey, slug) {
   return { workspaceId: data.workspaceId, projectId: data.projectId };
 }
 async function getAgentFiles(agentId, cwd, installMode = "global") {
-  const home = homedir4();
+  const home = homedir6();
   const files = [];
   const symlinks = [];
   switch (agentId) {
@@ -6221,17 +6562,17 @@ async function getAgentFiles(agentId, cwd, installMode = "global") {
           const content = buildSkillFile(fetched);
           if (installMode === "global") {
             files.push({
-              path: join5(GLOBAL_SKILLS_DIR, name, "SKILL.md"),
+              path: join7(GLOBAL_SKILLS_DIR, name, "SKILL.md"),
               content,
               type: "text"
             });
             symlinks.push({
-              target: join5(GLOBAL_SKILLS_DIR, name),
-              link: join5(home, ".claude", "skills", name)
+              target: join7(GLOBAL_SKILLS_DIR, name),
+              link: join7(home, ".claude", "skills", name)
             });
           } else {
             files.push({
-              path: join5(cwd, ".claude", "skills", name, "SKILL.md"),
+              path: join7(cwd, ".claude", "skills", name, "SKILL.md"),
               content,
               type: "text"
             });
@@ -6254,13 +6595,13 @@ ${summary}`);
           throw new Error(`hmy-update-check integrity check failed: expected ${updateCheckFetched.sha256}, got ${actualHash}`);
         }
         files.push({
-          path: join5(home, ".hmy", "bin", "hmy-update-check"),
+          path: join7(home, ".hmy", "bin", "hmy-update-check"),
           content: updateCheckFetched.content,
           type: "text",
           mode: 493
         });
         files.push({
-          path: join5(home, ".hmy", "VERSION"),
+          path: join7(home, ".hmy", "VERSION"),
           content: versionInfo.version,
           type: "text"
         });
@@ -6306,7 +6647,7 @@ Skip if: work was already started with a card reference, or no matching card exi
 - \`harmony_generate_prompt\` - Get role-based guidance and focus areas for the card
 `;
       files.push({
-        path: join5(cwd, "AGENTS.md"),
+        path: join7(cwd, "AGENTS.md"),
         content: agentsContent,
         type: "text"
       });
@@ -6323,17 +6664,17 @@ ${HARMONY_WORKFLOW_PROMPT.replace("$ARGUMENTS", "{{card}}").replace("Your agent
 `;
       if (installMode === "global") {
         files.push({
-          path: join5(GLOBAL_SKILLS_DIR, "codex", "hmy.md"),
+          path: join7(GLOBAL_SKILLS_DIR, "codex", "hmy.md"),
           content: promptContent,
           type: "text"
         });
         symlinks.push({
-          target: join5(GLOBAL_SKILLS_DIR, "codex", "hmy.md"),
-          link: join5(home, ".codex", "prompts", "hmy.md")
+          target: join7(GLOBAL_SKILLS_DIR, "codex", "hmy.md"),
+          link: join7(home, ".codex", "prompts", "hmy.md")
         });
       } else {
         files.push({
-          path: join5(home, ".codex", "prompts", "hmy.md"),
+          path: join7(home, ".codex", "prompts", "hmy.md"),
           content: promptContent,
           type: "text"
         });
@@ -6345,7 +6686,7 @@ command = "npx"
 args = ["-y", "@gethmy/mcp@latest", "serve"]
 `;
       files.push({
-        path: join5(home, ".codex", "config.toml"),
+        path: join7(home, ".codex", "config.toml"),
         content: tomlContent,
         type: "toml",
         tomlSection: "mcp_servers.harmony"
@@ -6354,7 +6695,7 @@ args = ["-y", "@gethmy/mcp@latest", "serve"]
     }
     case "cursor": {
       files.push({
-        path: join5(cwd, ".cursor", "mcp.json"),
+        path: join7(cwd, ".cursor", "mcp.json"),
         content: JSON.stringify({
           mcpServers: {
             harmony: {
@@ -6380,17 +6721,17 @@ ${HARMONY_WORKFLOW_PROMPT.replace("$ARGUMENTS", "the card reference").replace("Y
 `;
       if (installMode === "global") {
         files.push({
-          path: join5(GLOBAL_SKILLS_DIR, "cursor", "harmony.mdc"),
+          path: join7(GLOBAL_SKILLS_DIR, "cursor", "harmony.mdc"),
           content: ruleContent,
           type: "text"
         });
         symlinks.push({
-          target: join5(GLOBAL_SKILLS_DIR, "cursor", "harmony.mdc"),
-          link: join5(home, ".cursor", "rules", "harmony.mdc")
+          target: join7(GLOBAL_SKILLS_DIR, "cursor", "harmony.mdc"),
+          link: join7(home, ".cursor", "rules", "harmony.mdc")
         });
       } else {
         files.push({
-          path: join5(cwd, ".cursor", "rules", "harmony.mdc"),
+          path: join7(cwd, ".cursor", "rules", "harmony.mdc"),
           content: ruleContent,
           type: "text"
         });
@@ -6399,7 +6740,7 @@ ${HARMONY_WORKFLOW_PROMPT.replace("$ARGUMENTS", "the card reference").replace("Y
     }
     case "windsurf": {
       files.push({
-        path: join5(home, ".codeium", "windsurf", "mcp_config.json"),
+        path: join7(home, ".codeium", "windsurf", "mcp_config.json"),
         content: JSON.stringify({
           mcpServers: {
             harmony: {
@@ -6425,17 +6766,17 @@ ${HARMONY_WORKFLOW_PROMPT.replace("$ARGUMENTS", "the card reference").replace("Y
 `;
       if (installMode === "global") {
         files.push({
-          path: join5(GLOBAL_SKILLS_DIR, "windsurf", "harmony.md"),
+          path: join7(GLOBAL_SKILLS_DIR, "windsurf", "harmony.md"),
           content: ruleContent,
           type: "text"
         });
         symlinks.push({
-          target: join5(GLOBAL_SKILLS_DIR, "windsurf", "harmony.md"),
-          link: join5(home, ".codeium", "windsurf", "rules", "harmony.md")
+          target: join7(GLOBAL_SKILLS_DIR, "windsurf", "harmony.md"),
+          link: join7(home, ".codeium", "windsurf", "rules", "harmony.md")
         });
       } else {
         files.push({
-          path: join5(cwd, ".windsurf", "rules", "harmony.md"),
+          path: join7(cwd, ".windsurf", "rules", "harmony.md"),
           content: ruleContent,
           type: "text"
         });
@@ -6447,7 +6788,7 @@ ${HARMONY_WORKFLOW_PROMPT.replace("$ARGUMENTS", "the card reference").replace("Y
 }
 async function runSetup(options = {}) {
   const cwd = process.cwd();
-  const home = homedir4();
+  const home = homedir6();
   console.clear();
   console.log(messages.header());
   const existingConfig = loadConfig();
@@ -6855,7 +7196,7 @@ async function runSetup(options = {}) {
     for (const symlink of allSymlinks) {
       try {
         const linkDir = dirname3(symlink.link);
-        if (!existsSync7(linkDir)) {
+        if (!existsSync8(linkDir)) {
           mkdirSync5(linkDir, { recursive: true });
         }
         let linkExists = false;
@@ -6884,7 +7225,7 @@ async function runSetup(options = {}) {
     } else {
       try {
         await writeMcpConfigFallback(home);
-        console.log(`  ${colors.success("✓")} ${colors.dim(formatPath(join5(home, ".claude", "settings.json"), home))} ${colors.dim("(updated)")}`);
+        console.log(`  ${colors.success("✓")} ${colors.dim(formatPath(join7(home, ".claude", "settings.json"), home))} ${colors.dim("(updated)")}`);
       } catch {
         p3.log.warning("Could not register MCP server. Run manually: claude mcp add --transport stdio harmony -- npx -y @gethmy/mcp@latest serve");
       }
@@ -6951,9 +7292,9 @@ program.command("serve").description("Start the MCP server (stdio transport)").a
     console.error("Run: npx @gethmy/mcp setup");
     process.exit(1);
   }
-  await refreshSkills();
+  const { updated } = await refreshSkills();
   const server = new HarmonyMCPServer;
-  await server.run();
+  await server.run({ skillsUpdated: updated });
 });
 program.command("status").description("Show configuration status").action(() => {
   const globalConfig = loadConfig();