@gethmy/mcp 2.2.1 → 2.2.2

package/dist/cli.js

@@ -2122,19 +2122,19 @@ var require_commander = __commonJS((exports) => {
   exports.InvalidOptionArgumentError = InvalidArgumentError;
 });
 
-// ../memory/src/schema.ts
+// ../memory/dist/schema.js
 var init_schema = () => {};
 
-// ../memory/src/constraints.ts
+// ../memory/dist/constraints.js
 var init_constraints = __esm(() => {
   init_schema();
 });
-// ../memory/src/client.ts
+// ../memory/dist/client.js
 var init_client = __esm(() => {
   init_constraints();
 });
 
-// ../memory/src/graph-walk.ts
+// ../memory/dist/graph-walk.js
 async function discoverRelatedContext(client, startIds, maxDepth = 2, maxEntities = 20, minConfidence = 0.5) {
   const visited = new Set;
   const collectedEntities = [];
@@ -2215,7 +2215,7 @@ async function discoverRelatedContext(client, startIds, maxDepth = 2, maxEntitie
   };
 }
 
-// ../memory/src/lifecycle.ts
+// ../memory/dist/lifecycle.js
 function computeDecayScore(tier, lastAccessedAt, accessCount) {
   const halfLife = DECAY_HALF_LIVES[tier];
   const now = Date.now();
@@ -2300,7 +2300,7 @@ var init_lifecycle = __esm(() => {
   };
 });
 
-// ../memory/src/sync-storage.ts
+// ../memory/dist/sync-storage.js
 function parseSyncMarkdown(markdown) {
   const trimmed = markdown.trim();
   let frontmatter = {
@@ -2416,16 +2416,9 @@ function parseYamlArray(value) {
   return match[1].split(",").map((s) => s.trim()).filter(Boolean);
 }
 
-// ../memory/src/sync.ts
+// ../memory/dist/sync.js
 import { createHash } from "node:crypto";
-import {
-  existsSync as existsSync2,
-  mkdirSync as mkdirSync2,
-  readdirSync,
-  readFileSync as readFileSync2,
-  rmSync,
-  writeFileSync as writeFileSync2
-} from "node:fs";
+import { existsSync as existsSync2, mkdirSync as mkdirSync2, readdirSync, readFileSync as readFileSync2, rmSync, writeFileSync as writeFileSync2 } from "node:fs";
 import { join as join2, relative, sep } from "node:path";
 function computeFileHash(content) {
   return `sha256:${createHash("sha256").update(content).digest("hex")}`;
@@ -2690,8 +2683,8 @@ async function syncFull(client, config, workspaceId, projectId) {
 }
 var init_sync = () => {};
 
-// ../memory/src/index.ts
-var init_src = __esm(() => {
+// ../memory/dist/index.js
+var init_dist = __esm(() => {
   init_client();
   init_constraints();
   init_lifecycle();
@@ -9655,7 +9648,7 @@ async function recordContextFeedback(client2, cardId, sessionStatus, progressPer
 }
 var DEFAULT_TOKEN_BUDGET = 4000, MAX_TOKENS_PER_ENTITY = 500, MIN_RELEVANCE_THRESHOLD = 0.1, TIER_WEIGHTS, PROCEDURE_BUDGET_FRACTION = 0.15, TIER_BUDGET_ALLOCATION, MIN_REFERENCE_SLOTS = 3, manifestCache, MAX_CACHE_SIZE = 50, sessionAssemblyMap, MAX_SESSION_MAP_SIZE = 100;
 var init_context_assembly = __esm(() => {
-  init_src();
+  init_dist();
   TIER_WEIGHTS = {
     reference: 1,
     episode: 0.7,
@@ -10442,7 +10435,7 @@ function getMemoryDir() {
 }
 
 // src/server.ts
-init_src();
+init_dist();
 
 // ../../node_modules/zod/v4/core/index.js
 var exports_core2 = {};
@@ -28029,7 +28022,7 @@ function deriveClusterTitle(cluster, type) {
 init_context_assembly();
 
 // src/lifecycle-maintenance.ts
-init_src();
+init_dist();
 async function runLifecycleMaintenance(client3, workspaceId, projectId) {
   const result = {
     archived: 0,
@@ -28098,6 +28091,47 @@ async function runLifecycleMaintenance(client3, workspaceId, projectId) {
   return result;
 }
 
+// src/onboard.ts
+async function onboardNewUser(params) {
+  const {
+    email: email3,
+    password,
+    fullName,
+    workspaceName = `${fullName}'s Workspace`,
+    projectName = "My First Board",
+    template = "kanban",
+    keyName = "mcp-agent",
+    apiUrl = getApiUrl()
+  } = params;
+  const signupResult = await signupUser(apiUrl, {
+    email: email3,
+    password,
+    full_name: fullName
+  });
+  const token = signupResult.session.access_token;
+  const workspaceResult = await requestWithBearer(apiUrl, token, "POST", "/workspaces", {
+    name: workspaceName
+  });
+  const projectResult = await requestWithBearer(apiUrl, token, "POST", "/projects", {
+    workspaceId: workspaceResult.workspace.id,
+    name: projectName,
+    template
+  });
+  const keyResult = await requestWithBearer(apiUrl, token, "POST", "/api-keys", {
+    name: keyName
+  });
+  return {
+    user: signupResult.user,
+    workspace: workspaceResult.workspace,
+    project: projectResult.project,
+    columns: projectResult.columns,
+    apiKey: {
+      rawKey: keyResult.rawKey,
+      prefix: keyResult.apiKey.prefix
+    }
+  };
+}
+
 // src/server.ts
 var memorySessions = new Map;
 function initMemorySession(cardId, agentIdentifier, agentName) {
@@ -28232,18 +28266,22 @@ var TOOLS = {
     }
   },
   harmony_move_card: {
-    description: "Move a card to a different column or position",
+    description: "Move a card to a different column or position. Provide either columnId (UUID) or columnName (e.g. 'Review', 'Done').",
     inputSchema: {
       type: "object",
       properties: {
         cardId: { type: "string", description: "Card ID to move" },
-        columnId: { type: "string", description: "Target column ID" },
+        columnId: { type: "string", description: "Target column ID (UUID)" },
+        columnName: {
+          type: "string",
+          description: "Target column name (e.g. 'To Do', 'In Progress', 'Review', 'Done'). Used if columnId is not provided."
+        },
         position: {
           type: "number",
           description: "Position in column (0-indexed)"
         }
       },
-      required: ["cardId", "columnId"]
+      required: ["cardId"]
     }
   },
   harmony_archive_card: {
@@ -28374,14 +28412,21 @@ var TOOLS = {
     }
   },
   harmony_add_label_to_card: {
-    description: "Add a label to a card",
+    description: "Add a label to a card. Provide labelId directly, or labelName to look up (or auto-create) the label by name.",
     inputSchema: {
       type: "object",
       properties: {
         cardId: { type: "string" },
-        labelId: { type: "string" }
+        labelId: {
+          type: "string",
+          description: "Label ID (optional if labelName provided)"
+        },
+        labelName: {
+          type: "string",
+          description: "Label name — will look up or create if not found"
+        }
       },
-      required: ["cardId", "labelId"]
+      required: ["cardId"]
     }
   },
   harmony_remove_label_from_card: {
@@ -29698,6 +29743,17 @@ function registerHandlers(server, deps) {
     throw new Error(`Unknown resource: ${uri}`);
   });
 }
+async function resolveColumnByName(client3, projectId, columnName) {
+  const board = await client3.getBoard(projectId, { summary: true });
+  const columns = board.columns;
+  const lower = columnName.toLowerCase();
+  const col = columns.find((c) => c.name.toLowerCase() === lower) || columns.find((c) => c.name.toLowerCase().includes(lower));
+  if (!col) {
+    const available = columns.map((c) => c.name).join(", ");
+    throw new Error(`Column "${columnName}" not found. Available columns: ${available}`);
+  }
+  return col;
+}
 async function handleToolCall(name, args, deps) {
   const unauthenticatedTools = ["harmony_signup", "harmony_onboard"];
   if (!unauthenticatedTools.includes(name) && !deps.isConfigured()) {
@@ -29747,16 +29803,29 @@ async function handleToolCall(name, args, deps) {
     }
     case "harmony_move_card": {
       const cardId = exports_external.string().uuid().parse(args.cardId);
-      const columnId = exports_external.string().uuid().parse(args.columnId);
       const position = args.position !== undefined ? exports_external.number().int().min(0).parse(args.position) : undefined;
+      let columnId;
+      let resolvedProjectId;
+      if (args.columnId) {
+        columnId = exports_external.string().uuid().parse(args.columnId);
+      } else if (args.columnName) {
+        const columnName = exports_external.string().parse(args.columnName);
+        const { card: cardForProject } = await client3.getCard(cardId);
+        resolvedProjectId = cardForProject?.project_id;
+        if (!resolvedProjectId)
+          throw new Error("Card has no project");
+        const col = await resolveColumnByName(client3, resolvedProjectId, columnName);
+        columnId = col.id;
+      } else {
+        throw new Error("Either columnId or columnName is required");
+      }
       const result = await client3.moveCard(cardId, columnId, position);
       let sessionEnded = false;
       try {
         const { card } = result;
-        if (card?.project_id) {
-          const board = await client3.getBoard(card.project_id, {
-            summary: true
-          });
+        const projectId = card?.project_id || resolvedProjectId;
+        if (projectId) {
+          const board = await client3.getBoard(projectId, { summary: true });
           const columns = board.columns;
           const destCol = columns.find((c) => c.id === columnId);
           const colName = destCol?.name?.toLowerCase() || "";
@@ -29843,7 +29912,32 @@ async function handleToolCall(name, args, deps) {
     }
     case "harmony_add_label_to_card": {
       const cardId = exports_external.string().uuid().parse(args.cardId);
-      const labelId = exports_external.string().uuid().parse(args.labelId);
+      let labelId = args.labelId ? exports_external.string().uuid().parse(args.labelId) : undefined;
+      const labelName = args.labelName ? exports_external.string().min(1).max(100).parse(args.labelName) : undefined;
+      if (!labelId && labelName) {
+        const { card } = await client3.getCard(cardId);
+        const projectId = card.project_id;
+        if (!projectId) {
+          throw new Error("Cannot resolve label by name: card has no project_id");
+        }
+        if (projectId) {
+          const board = await client3.getBoard(projectId, { summary: true });
+          const labels = board.labels;
+          const existing = labels.find((l) => l.name.toLowerCase() === labelName.toLowerCase());
+          if (existing) {
+            labelId = existing.id;
+          } else {
+            const created = await client3.createLabel(projectId, {
+              name: labelName,
+              color: "#57b8a5"
+            });
+            labelId = created.label.id;
+          }
+        }
+      }
+      if (!labelId) {
+        throw new Error("Either labelId or labelName must be provided");
+      }
       await client3.addLabelToCard(cardId, labelId);
       return { success: true };
     }
@@ -29973,10 +30067,17 @@ async function handleToolCall(name, args, deps) {
             }
             if (addLabels?.length) {
               for (const labelName of addLabels) {
-                const label = labels.find((l) => l.name.toLowerCase() === labelName.toLowerCase());
+                let label = labels.find((l) => l.name.toLowerCase() === labelName.toLowerCase());
+                if (!label && projectId) {
+                  const created = await client3.createLabel(projectId, {
+                    name: labelName,
+                    color: "#57b8a5"
+                  });
+                  label = created.label;
+                }
                 if (label) {
                   await client3.addLabelToCard(cardId, label.id);
-                  labelsAdded.push(label.name);
+                  labelsAdded.push(label.name ?? labelName);
                 }
               }
             }
@@ -30096,27 +30197,21 @@ async function handleToolCall(name, args, deps) {
       const endProgressPercent = args.progressPercent !== undefined ? exports_external.number().min(0).max(100).parse(args.progressPercent) : undefined;
       await flushMemoryActions(client3, cardId);
       cleanupMemorySession(cardId);
-      const result = await client3.endAgentSession(cardId, {
-        status: sessionStatus,
-        progressPercent: endProgressPercent
-      });
+      let result = { session: null };
+      let sessionEndError = null;
+      try {
+        result = await client3.endAgentSession(cardId, {
+          status: sessionStatus,
+          progressPercent: endProgressPercent
+        });
+      } catch (err) {
+        sessionEndError = err instanceof Error ? err.message : "Failed to end session";
+      }
       untrack(cardId);
       let movedTo = null;
-      const _learningsExtracted = 0;
-      let _cardTitle = "";
-      let _cardLabels = [];
-      let _cardDescription = "";
-      let _cardSubtasks = [];
       try {
         const { card } = await client3.getCard(cardId);
         const typedCard = card;
-        _cardTitle = typedCard.title || "";
-        _cardLabels = (typedCard.labels || []).map((l) => l.name);
-        _cardDescription = typedCard.description || "";
-        _cardSubtasks = (typedCard.subtasks || []).map((s) => ({
-          title: s.title,
-          done: s.done
-        }));
         const projectId = typedCard.project_id;
         if (sessionStatus === "completed" && typedCard.labels?.length) {
           const agentLabel = typedCard.labels.find((l) => l.name.toLowerCase() === "agent");
@@ -30125,21 +30220,16 @@ async function handleToolCall(name, args, deps) {
           }
         }
         if (moveToColumn && projectId) {
-          const board = await client3.getBoard(projectId, {
-            summary: true
-          });
-          const columns = board.columns;
-          const col = columns.find((c) => c.name.toLowerCase().includes(moveToColumn.toLowerCase()));
-          if (col) {
-            await client3.moveCard(cardId, col.id);
-            movedTo = col.name;
-          }
+          const col = await resolveColumnByName(client3, projectId, moveToColumn);
+          await client3.moveCard(cardId, col.id);
+          movedTo = col.name;
         }
       } catch {}
       const sessionObj = result.session;
       const pipelineResult = await runEndSessionPipeline(client3, deps, cardId, sessionStatus, endProgressPercent, sessionObj);
       return {
         success: true,
+        ...sessionEndError && { sessionEndError },
         movedTo,
         learningsExtracted: pipelineResult.learningsExtracted,
         feedbackAdjusted: pipelineResult.feedbackAdjusted,
@@ -30881,38 +30971,27 @@ async function handleToolCall(name, args, deps) {
       const projectName = args.projectName || "My First Project";
       const template = args.template || "kanban";
       const keyName = args.keyName || "mcp-agent";
-      const apiUrl = deps.getApiUrl();
-      const signupResult = await signupUser(apiUrl, {
+      const result = await onboardNewUser({
         email: email3,
         password,
-        full_name: fullName
-      });
-      const token = signupResult.session.access_token;
-      const workspaceResult = await requestWithBearer(apiUrl, token, "POST", "/workspaces", {
-        name: workspaceName
+        fullName,
+        workspaceName,
+        projectName,
+        template,
+        keyName,
+        apiUrl: deps.getApiUrl()
       });
-      const projectResult = await requestWithBearer(apiUrl, token, "POST", "/projects", {
-        workspaceId: workspaceResult.workspace.id,
-        name: projectName,
-        template
-      });
-      const keyResult = await requestWithBearer(apiUrl, token, "POST", "/api-keys", {
-        name: keyName
-      });
-      deps.saveConfig({ apiKey: keyResult.rawKey });
-      deps.setActiveWorkspace(workspaceResult.workspace.id);
-      deps.setActiveProject(projectResult.project.id);
+      deps.saveConfig({ apiKey: result.apiKey.rawKey });
+      deps.setActiveWorkspace(result.workspace.id);
+      deps.setActiveProject(result.project.id);
       deps.resetClient();
       return {
         success: true,
-        user: signupResult.user,
-        workspace: workspaceResult.workspace,
-        project: projectResult.project,
-        columns: projectResult.columns,
-        apiKey: {
-          rawKey: keyResult.rawKey,
-          prefix: keyResult.apiKey.prefix
-        },
+        user: result.user,
+        workspace: result.workspace,
+        project: result.project,
+        columns: result.columns,
+        apiKey: result.apiKey,
         message: `Onboarding complete! Account created for ${email3}. Workspace "${workspaceName}" and project "${projectName}" are ready. API key saved to config.`
       };
     }
@@ -31972,6 +32051,30 @@ var SD = class extends x {
     this.value = u ? this.value.filter((t) => t !== this._value) : [...this.value, this._value];
   }
 };
+var TD = Object.defineProperty;
+var jD = (e, u, t) => (u in e) ? TD(e, u, { enumerable: true, configurable: true, writable: true, value: t }) : e[u] = t;
+var U = (e, u, t) => (jD(e, typeof u != "symbol" ? u + "" : u, t), t);
+
+class MD extends x {
+  constructor({ mask: u, ...t }) {
+    super(t), U(this, "valueWithCursor", ""), U(this, "_mask", "•"), this._mask = u ?? "•", this.on("finalize", () => {
+      this.valueWithCursor = this.masked;
+    }), this.on("value", () => {
+      if (this.cursor >= this.value.length)
+        this.valueWithCursor = `${this.masked}${import_picocolors.default.inverse(import_picocolors.default.hidden("_"))}`;
+      else {
+        const F = this.masked.slice(0, this.cursor), s = this.masked.slice(this.cursor);
+        this.valueWithCursor = `${F}${import_picocolors.default.inverse(s[0])}${s.slice(1)}`;
+      }
+    });
+  }
+  get cursor() {
+    return this._cursor;
+  }
+  get masked() {
+    return this.value.replaceAll(/./g, this._mask);
+  }
+}
 var OD = Object.defineProperty;
 var PD = (e, u, t) => (u in e) ? OD(e, u, { enumerable: true, configurable: true, writable: true, value: t }) : e[u] = t;
 var J = (e, u, t) => (PD(e, typeof u != "symbol" ? u + "" : u, t), t);
@@ -32046,7 +32149,7 @@ var de = u("├", "+");
 var pe = u("╯", "+");
 var q = u("●", "•");
 var D = u("◆", "*");
-var U = u("▲", "!");
+var U2 = u("▲", "!");
 var K2 = u("■", "x");
 var b2 = (t) => {
   switch (t) {
@@ -32092,6 +32195,27 @@ ${import_picocolors2.default.cyan(d2)}
 `;
   }
 } }).prompt();
+var ge = (t) => new MD({ validate: t.validate, mask: t.mask ?? $e, render() {
+  const n = `${import_picocolors2.default.gray(o)}
+${b2(this.state)}  ${t.message}
+`, r2 = this.valueWithCursor, i = this.masked;
+  switch (this.state) {
+    case "error":
+      return `${n.trim()}
+${import_picocolors2.default.yellow(o)}  ${i}
+${import_picocolors2.default.yellow(d2)}  ${import_picocolors2.default.yellow(this.error)}
+`;
+    case "submit":
+      return `${n}${import_picocolors2.default.gray(o)}  ${import_picocolors2.default.dim(i)}`;
+    case "cancel":
+      return `${n}${import_picocolors2.default.gray(o)}  ${import_picocolors2.default.strikethrough(import_picocolors2.default.dim(i ?? ""))}${i ? `
+${import_picocolors2.default.gray(o)}` : ""}`;
+    default:
+      return `${n}${import_picocolors2.default.cyan(o)}  ${r2}
+${import_picocolors2.default.cyan(d2)}
+`;
+  }
+} }).prompt();
 var ye = (t) => {
   const n = t.active ?? "Yes", r2 = t.inactive ?? "No";
   return new dD({ active: n, inactive: r2, initialValue: t.initialValue ?? true, render() {
@@ -32212,7 +32336,7 @@ var M2 = { message: (t = "", { symbol: n = import_picocolors2.default.gray(o) }
 }, step: (t) => {
   M2.message(t, { symbol: import_picocolors2.default.green(C) });
 }, warn: (t) => {
-  M2.message(t, { symbol: import_picocolors2.default.yellow(U) });
+  M2.message(t, { symbol: import_picocolors2.default.yellow(U2) });
 }, warning: (t) => {
   M2.warn(t);
 }, error: (t) => {
@@ -33519,42 +33643,156 @@ async function runSetup(options = {}) {
   }
   let apiKey = options.apiKey || existingConfig.apiKey;
   let userEmail = options.userEmail || existingConfig.userEmail || undefined;
+  let selectedWorkspaceIdFromSignup;
+  let selectedProjectIdFromSignup;
+  let selectedWorkspaceNameFromSignup;
+  let selectedProjectNameFromSignup;
+  let createdNewAccount = false;
   if (needsApiKey || !apiKey || !apiKey.startsWith("hmy_")) {
-    const keyInput = await he({
-      message: "Enter your Harmony API key",
-      placeholder: "hmy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
-      validate: (value) => {
-        if (!value)
-          return "API key is required";
-        if (!value.startsWith("hmy_"))
-          return 'API key must start with "hmy_"';
-        if (value.length < 20)
-          return "API key is too short";
-        return;
+    let useNewAccount = options.newAccount === true;
+    if (!useNewAccount && options.apiKey) {
+      useNewAccount = false;
+    } else if (!useNewAccount && !options.apiKey) {
+      const getStarted = await ve({
+        message: "How would you like to get started?",
+        options: [
+          {
+            value: "create",
+            label: "Create a free account",
+            hint: "recommended for new users"
+          },
+          {
+            value: "apikey",
+            label: "I already have an API key"
+          }
+        ]
+      });
+      if (pD(getStarted)) {
+        xe("Setup cancelled");
+        process.exit(0);
       }
-    });
-    if (pD(keyInput)) {
-      xe("Setup cancelled");
-      process.exit(0);
+      useNewAccount = getStarted === "create";
+    }
+    if (useNewAccount) {
+      const fullName = options.name || await he({
+        message: "Full name",
+        placeholder: "Jane Smith",
+        validate: (v2) => {
+          if (!v2 || v2.trim().length === 0)
+            return "Name is required";
+          if (v2.length > 100)
+            return "Name must be 100 characters or less";
+          return;
+        }
+      });
+      if (pD(fullName)) {
+        xe("Setup cancelled");
+        process.exit(0);
+      }
+      const email3 = options.userEmail || await he({
+        message: "Email",
+        placeholder: "you@example.com",
+        validate: (v2) => {
+          if (!v2)
+            return "Email is required";
+          if (v2.length > 254)
+            return "Email is too long";
+          if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(v2))
+            return "Invalid email format";
+          return;
+        }
+      });
+      if (pD(email3)) {
+        xe("Setup cancelled");
+        process.exit(0);
+      }
+      const password = await ge({
+        message: "Password",
+        validate: (v2) => {
+          if (!v2)
+            return "Password is required";
+          if (v2.length < 8)
+            return "Password must be at least 8 characters";
+          if (v2.length > 128)
+            return "Password must be 128 characters or less";
+          return;
+        }
+      });
+      if (pD(password)) {
+        xe("Setup cancelled");
+        process.exit(0);
+      }
+      const spinner2 = Y2();
+      spinner2.start("Creating your account...");
+      try {
+        const result = await onboardNewUser({
+          email: email3,
+          password,
+          fullName
+        });
+        spinner2.stop(colors.success(`Account created for ${result.user.email}`));
+        apiKey = result.apiKey.rawKey;
+        userEmail = result.user.email;
+        selectedWorkspaceIdFromSignup = result.workspace.id;
+        selectedProjectIdFromSignup = result.project.id;
+        selectedWorkspaceNameFromSignup = result.workspace.name;
+        selectedProjectNameFromSignup = result.project.name;
+        createdNewAccount = true;
+        needsApiKey = true;
+        saveConfig({ apiKey, userEmail, apiUrl: API_URL });
+        setActiveWorkspace(selectedWorkspaceIdFromSignup);
+        setActiveProject(selectedProjectIdFromSignup);
+        M2.success("Workspace and board created");
+      } catch (error48) {
+        spinner2.stop(colors.error("Account creation failed"));
+        const msg = error48 instanceof Error ? error48.message : "Unknown error";
+        if (msg.includes("already") || msg.includes("409")) {
+          M2.error("Account already exists. Sign in at app.gethmy.com to get your API key, or re-run setup and choose 'I already have an API key'.");
+        } else {
+          M2.error(msg);
+          M2.info("Please try again or visit https://app.gethmy.com");
+        }
+        process.exit(1);
+      }
+    } else {
+      const keyInput = await he({
+        message: "Enter your Harmony API key",
+        placeholder: "hmy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+        validate: (value) => {
+          if (!value)
+            return "API key is required";
+          if (!value.startsWith("hmy_"))
+            return 'API key must start with "hmy_"';
+          if (value.length < 20)
+            return "API key is too short";
+          return;
+        }
+      });
+      if (pD(keyInput)) {
+        xe("Setup cancelled");
+        process.exit(0);
+      }
+      apiKey = keyInput;
+      needsApiKey = true;
     }
-    apiKey = keyInput;
-    needsApiKey = true;
   } else {
     M2.success(`Using existing API key: ${apiKey.slice(0, 8)}...`);
   }
   const spinner = Y2();
-  spinner.start("Validating API key...");
-  const validation = await validateApiKey(apiKey);
-  if (!validation.valid) {
-    spinner.stop(colors.error("API key validation failed"));
-    M2.error(validation.error || "Could not connect to Harmony API");
-    M2.info("Get an API key at: https://app.gethmy.com/user/keys");
-    process.exit(1);
-  }
-  if (!userEmail) {
-    userEmail = validation.email;
+  if (!createdNewAccount) {
+    spinner.start("Validating API key...");
+    const validation = await validateApiKey(apiKey);
+    if (!validation.valid) {
+      spinner.stop(colors.error("API key validation failed"));
+      M2.error(validation.error || "Could not connect to Harmony API");
+      M2.info("Get an API key at: https://app.gethmy.com/user/keys");
+      process.exit(1);
+    }
+    if (!userEmail) {
+      userEmail = validation.email;
+    }
+    spinner.stop(colors.success(userEmail ? `Connected as ${userEmail}` : "API key validated"));
   }
-  spinner.stop(colors.success(userEmail ? `Connected as ${userEmail}` : "API key validated"));
   let selectedAgents = [];
   let installMode = options.installMode || "global";
   if (skillsStatus.installed && !options.force) {
@@ -33618,10 +33856,13 @@ async function runSetup(options = {}) {
       installMode = modeSelection;
     }
   }
-  let selectedWorkspaceId = options.workspaceId;
-  let selectedProjectId = options.projectId;
-  let selectedWorkspaceName;
-  let selectedProjectName;
+  let selectedWorkspaceId = selectedWorkspaceIdFromSignup || options.workspaceId;
+  let selectedProjectId = selectedProjectIdFromSignup || options.projectId;
+  let selectedWorkspaceName = selectedWorkspaceNameFromSignup;
+  let selectedProjectName = selectedProjectNameFromSignup;
+  if (createdNewAccount) {
+    needsContext = false;
+  }
   if (needsContext && !options.skipContext) {
     spinner.start("Fetching workspaces...");
     let workspaces = [];
@@ -33826,30 +34067,44 @@ async function runSetup(options = {}) {
   }
   console.log("");
   Se(colors.success("Setup complete!"));
-  console.log("");
-  console.log(`  ${colors.bold("Configuration:")}`);
-  console.log(`    API key:   ${formatPath(getConfigPath(), home)}`);
-  if (needsSkills && selectedAgents.length > 0) {
-    console.log(`    Skills:    ${installMode === "global" ? "~/.agents/skills/ (global)" : ".claude/skills/ (local)"}`);
-  }
-  if (selectedWorkspaceId || selectedProjectId) {
-    console.log(`    Context:   ${formatPath(getLocalConfigPath(cwd), home)}`);
-  }
-  console.log("");
-  console.log(`  ${colors.bold("Usage:")}`);
-  if (!needsSkills || selectedAgents.includes("claude")) {
-    console.log(`    ${colors.brand("Claude Code:")} ${colors.highlight("/hmy #42")} or ${colors.highlight("/hmy-plan")} ${colors.dim("(create or execute plans)")}`);
-  }
-  if (selectedAgents.includes("codex")) {
-    console.log(`    ${colors.brand("Codex:")} ${colors.highlight("/prompts:hmy #42")}`);
-  }
-  if (selectedAgents.includes("cursor") || selectedAgents.includes("windsurf")) {
-    console.log(`    ${colors.brand("Cursor/Windsurf:")} MCP tools available automatically`);
+  if (createdNewAccount && selectedWorkspaceNameFromSignup) {
+    const wsSlug = selectedWorkspaceNameFromSignup.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "");
+    const projSlug = (selectedProjectNameFromSignup || "my-first-board").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "");
+    console.log("");
+    console.log(`  ${colors.bold("Your board:")} ${colors.highlight(`https://app.gethmy.com/${wsSlug}/${projSlug}`)}`);
+    console.log("");
+    console.log(`  ${colors.bold("Next steps:")}`);
+    console.log(`    1. Open Claude Code and say: ${colors.highlight('"Show me my board"')}`);
+    console.log(`    2. Create a card: ${colors.highlight('"Create a card called Auth token refresh"')}`);
+    console.log(`    3. Start the daemon: ${colors.highlight("npx @gethmy/agent")}`);
+    console.log("");
+    console.log(`  ${colors.dim("Happy shipping!")}`);
+  } else {
+    console.log("");
+    console.log(`  ${colors.bold("Configuration:")}`);
+    console.log(`    API key:   ${formatPath(getConfigPath(), home)}`);
+    if (needsSkills && selectedAgents.length > 0) {
+      console.log(`    Skills:    ${installMode === "global" ? "~/.agents/skills/ (global)" : ".claude/skills/ (local)"}`);
+    }
+    if (selectedWorkspaceId || selectedProjectId) {
+      console.log(`    Context:   ${formatPath(getLocalConfigPath(cwd), home)}`);
+    }
+    console.log("");
+    console.log(`  ${colors.bold("Usage:")}`);
+    if (!needsSkills || selectedAgents.includes("claude")) {
+      console.log(`    ${colors.brand("Claude Code:")} ${colors.highlight("/hmy #42")} or ${colors.highlight("/hmy-plan")} ${colors.dim("(create or execute plans)")}`);
+    }
+    if (selectedAgents.includes("codex")) {
+      console.log(`    ${colors.brand("Codex:")} ${colors.highlight("/prompts:hmy #42")}`);
+    }
+    if (selectedAgents.includes("cursor") || selectedAgents.includes("windsurf")) {
+      console.log(`    ${colors.brand("Cursor:")} MCP tools available automatically`);
+    }
+    console.log("");
+    console.log(`  ${colors.dim("Add to new project: npx @gethmy/mcp setup")}`);
+    console.log(`  ${colors.dim("Need help? Visit https://app.gethmy.com/docs/mcp")}`);
   }
   console.log("");
-  console.log(`  ${colors.dim("Add to new project: npx @gethmy/mcp setup")}`);
-  console.log(`  ${colors.dim("Need help? Visit https://app.gethmy.com/docs/mcp")}`);
-  console.log("");
 }
 
 // src/cli.ts
@@ -33857,6 +34112,11 @@ var require2 = createRequire2(import.meta.url);
 var { version: version2 } = require2("../package.json");
 program.name("@gethmy/mcp").description("MCP server for Harmony Kanban board").version(version2);
 program.command("serve").description("Start the MCP server (stdio transport)").action(async () => {
+  if (!isConfigured()) {
+    console.error("No API key configured.");
+    console.error("Run: npx @gethmy/mcp setup");
+    process.exit(1);
+  }
   await refreshSkills();
   const server = new HarmonyMCPServer;
   await server.run();
@@ -33926,7 +34186,7 @@ program.command("reset").description("Remove stored configuration").action(() =>
   console.log(`
 To reconfigure, run: npx @gethmy/mcp setup`);
 });
-program.command("setup").description("Smart setup wizard for Harmony MCP (recommended)").option("-f, --force", "Overwrite existing configuration files").option("-k, --api-key <key>", "API key (skips prompt)").option("-e, --email <email>", "Your email for auto-assignment").option("-a, --agents <agents...>", "Agents to configure: claude, codex, cursor, windsurf").option("-l, --local", "Install skills locally in project directory").option("-g, --global", "Install skills globally (recommended)").option("-w, --workspace <id>", "Set workspace context").option("-p, --project <id>", "Set project context").option("--skip-context", "Skip workspace/project selection").option("--skip-docs", "Skip project docs scaffold/verification").action(async (options) => {
+program.command("setup").description("Smart setup wizard for Harmony MCP (recommended)").option("-f, --force", "Overwrite existing configuration files").option("-k, --api-key <key>", "API key (skips prompt)").option("-e, --email <email>", "Your email for auto-assignment").option("-a, --agents <agents...>", "Agents to configure: claude, codex, cursor, windsurf").option("-l, --local", "Install skills locally in project directory").option("-g, --global", "Install skills globally (recommended)").option("-w, --workspace <id>", "Set workspace context").option("-p, --project <id>", "Set project context").option("--skip-context", "Skip workspace/project selection").option("--skip-docs", "Skip project docs scaffold/verification").option("--new", "Create a new account (skip the choice prompt)").option("-n, --name <name>", "Full name (for account creation)").action(async (options) => {
   await runSetup({
     force: options.force,
     apiKey: options.apiKey,
@@ -33936,7 +34196,9 @@ program.command("setup").description("Smart setup wizard for Harmony MCP (recomm
     workspaceId: options.workspace,
     projectId: options.project,
     skipContext: options.skipContext,
-    skipDocs: options.skipDocs
+    skipDocs: options.skipDocs,
+    newAccount: options.new,
+    name: options.name
   });
 });
 program.parse();