@gethmy/mcp 2.2.0 → 2.2.2

package/src/tui/setup.ts

@@ -15,8 +15,12 @@ import {
   hasProjectContext,
   isConfigured,
   loadConfig,
+  saveConfig,
   saveLocalConfig,
+  setActiveProject,
+  setActiveWorkspace,
 } from "../config.js";
+import { onboardNewUser } from "../onboard.js";
 import { buildSkillFile, HARMONY_WORKFLOW_PROMPT } from "../skills.js";
 import { type AgentId, detectAgents } from "./agents.js";
 import { runDocsStep } from "./docs.js";
@@ -35,6 +39,8 @@ export interface SetupOptions {
   projectId?: string;
   skipContext?: boolean;
   skipDocs?: boolean;
+  newAccount?: boolean;
+  name?: string;
 }
 
 // Central skills directory for global installation
@@ -499,55 +505,191 @@ export async function runSetup(options: SetupOptions = {}): Promise<void> {
     needsContext = true;
   }
 
-  // Step 1: API Key
+  // Step 1: API Key (or create account)
   let apiKey = options.apiKey || existingConfig.apiKey;
   let userEmail: string | undefined =
     options.userEmail || existingConfig.userEmail || undefined;
+  let selectedWorkspaceIdFromSignup: string | undefined;
+  let selectedProjectIdFromSignup: string | undefined;
+  let selectedWorkspaceNameFromSignup: string | undefined;
+  let selectedProjectNameFromSignup: string | undefined;
+  let createdNewAccount = false;
 
   if (needsApiKey || !apiKey || !apiKey.startsWith("hmy_")) {
-    const keyInput = await p.text({
-      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 undefined;
-      },
-    });
+    // Determine path: create account or enter API key
+    let useNewAccount = options.newAccount === true;
+
+    if (!useNewAccount && options.apiKey) {
+      // API key passed via flag — skip the choice prompt
+      useNewAccount = false;
+    } else if (!useNewAccount && !options.apiKey) {
+      const getStarted = await p.select({
+        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 (p.isCancel(keyInput)) {
-      p.cancel("Setup cancelled");
-      process.exit(0);
+      if (p.isCancel(getStarted)) {
+        p.cancel("Setup cancelled");
+        process.exit(0);
+      }
+
+      useNewAccount = getStarted === "create";
     }
 
-    apiKey = keyInput as string;
-    needsApiKey = true;
+    if (useNewAccount) {
+      // --- Create account flow ---
+      const fullName =
+        options.name ||
+        ((await p.text({
+          message: "Full name",
+          placeholder: "Jane Smith",
+          validate: (v) => {
+            if (!v || v.trim().length === 0) return "Name is required";
+            if (v.length > 100) return "Name must be 100 characters or less";
+            return undefined;
+          },
+        })) as string);
+
+      if (p.isCancel(fullName)) {
+        p.cancel("Setup cancelled");
+        process.exit(0);
+      }
+
+      const email =
+        options.userEmail ||
+        ((await p.text({
+          message: "Email",
+          placeholder: "you@example.com",
+          validate: (v) => {
+            if (!v) return "Email is required";
+            if (v.length > 254) return "Email is too long";
+            if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(v))
+              return "Invalid email format";
+            return undefined;
+          },
+        })) as string);
+
+      if (p.isCancel(email)) {
+        p.cancel("Setup cancelled");
+        process.exit(0);
+      }
+
+      const password = (await p.password({
+        message: "Password",
+        validate: (v) => {
+          if (!v) return "Password is required";
+          if (v.length < 8) return "Password must be at least 8 characters";
+          if (v.length > 128) return "Password must be 128 characters or less";
+          return undefined;
+        },
+      })) as string;
+
+      if (p.isCancel(password)) {
+        p.cancel("Setup cancelled");
+        process.exit(0);
+      }
+
+      const spinner = p.spinner();
+      spinner.start("Creating your account...");
+
+      try {
+        const result = await onboardNewUser({
+          email: email as string,
+          password: password as string,
+          fullName: fullName as string,
+        });
+
+        spinner.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;
+
+        // Save config immediately
+        saveConfig({ apiKey, userEmail, apiUrl: API_URL });
+        setActiveWorkspace(selectedWorkspaceIdFromSignup);
+        setActiveProject(selectedProjectIdFromSignup);
+
+        p.log.success("Workspace and board created");
+      } catch (error) {
+        spinner.stop(colors.error("Account creation failed"));
+        const msg = error instanceof Error ? error.message : "Unknown error";
+        if (msg.includes("already") || msg.includes("409")) {
+          p.log.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 {
+          p.log.error(msg);
+          p.log.info("Please try again or visit https://app.gethmy.com");
+        }
+        process.exit(1);
+      }
+    } else {
+      // --- Existing API key flow ---
+      const keyInput = await p.text({
+        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 undefined;
+        },
+      });
+
+      if (p.isCancel(keyInput)) {
+        p.cancel("Setup cancelled");
+        process.exit(0);
+      }
+
+      apiKey = keyInput as string;
+      needsApiKey = true;
+    }
   } else {
     p.log.success(`Using existing API key: ${apiKey.slice(0, 8)}...`);
   }
 
-  // Validate API key
+  // Validate API key (skip if we just created account — key is guaranteed valid)
   const spinner = p.spinner();
-  spinner.start("Validating API key...");
+  if (!createdNewAccount) {
+    spinner.start("Validating API key...");
 
-  const validation = await validateApiKey(apiKey);
+    const validation = await validateApiKey(apiKey);
 
-  if (!validation.valid) {
-    spinner.stop(colors.error("API key validation failed"));
-    p.log.error(validation.error || "Could not connect to Harmony API");
-    p.log.info("Get an API key at: https://app.gethmy.com/user/keys");
-    process.exit(1);
-  }
+    if (!validation.valid) {
+      spinner.stop(colors.error("API key validation failed"));
+      p.log.error(validation.error || "Could not connect to Harmony API");
+      p.log.info("Get an API key at: https://app.gethmy.com/user/keys");
+      process.exit(1);
+    }
 
-  if (!userEmail) {
-    userEmail = validation.email;
+    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",
-    ),
-  );
 
   // Step 2: Check if skills are already installed
   let selectedAgents: AgentId[] = [];
@@ -633,10 +775,17 @@ export async function runSetup(options: SetupOptions = {}): Promise<void> {
   }
 
   // Step 3: Workspace and Project Selection
-  let selectedWorkspaceId = options.workspaceId;
-  let selectedProjectId = options.projectId;
-  let selectedWorkspaceName: string | undefined;
-  let selectedProjectName: string | undefined;
+  let selectedWorkspaceId =
+    selectedWorkspaceIdFromSignup || options.workspaceId;
+  let selectedProjectId = selectedProjectIdFromSignup || options.projectId;
+  let selectedWorkspaceName: string | undefined =
+    selectedWorkspaceNameFromSignup;
+  let selectedProjectName: string | undefined = selectedProjectNameFromSignup;
+
+  // Skip context selection if we just created a new account
+  if (createdNewAccount) {
+    needsContext = false;
+  }
 
   if (needsContext && !options.skipContext) {
     // Fetch workspaces
@@ -935,46 +1084,79 @@ export async function runSetup(options: SetupOptions = {}): Promise<void> {
   console.log("");
   p.outro(colors.success("Setup complete!"));
 
-  console.log("");
-  console.log(`  ${colors.bold("Configuration:")}`);
-  console.log(`    API key:   ${formatPath(getConfigPath(), home)}`);
-  if (needsSkills && selectedAgents.length > 0) {
+  if (createdNewAccount && selectedWorkspaceNameFromSignup) {
+    // New account: show board URL and next steps
+    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(
-      `    Skills:    ${installMode === "global" ? "~/.agents/skills/ (global)" : ".claude/skills/ (local)"}`,
+      `  ${colors.bold("Your board:")} ${colors.highlight(`https://app.gethmy.com/${wsSlug}/${projSlug}`)}`,
     );
-  }
-  if (selectedWorkspaceId || selectedProjectId) {
-    console.log(`    Context:   ${formatPath(getLocalConfigPath(cwd), home)}`);
-  }
-
-  console.log("");
-  console.log(`  ${colors.bold("Usage:")}`);
-
-  if (!needsSkills || selectedAgents.includes("claude")) {
+    console.log("");
+    console.log(`  ${colors.bold("Next steps:")}`);
     console.log(
-      `    ${colors.brand("Claude Code:")} ${colors.highlight("/hmy #42")} or ${colors.highlight("/hmy-plan")} ${colors.dim("(create or execute plans)")}`,
+      `    1. Open Claude Code and say: ${colors.highlight('"Show me my board"')}`,
     );
-  }
-
-  if (selectedAgents.includes("codex")) {
     console.log(
-      `    ${colors.brand("Codex:")} ${colors.highlight("/prompts:hmy #42")}`,
+      `    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 {
+    // Existing user: show config paths and usage
+    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("cursor") ||
-    selectedAgents.includes("windsurf")
-  ) {
+    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.brand("Cursor/Windsurf:")} MCP tools available automatically`,
+      `  ${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("");
 }