@uluops/setup 0.6.0 → 0.6.4

package/README.md

@@ -47,7 +47,7 @@ npx @uluops/setup --harness gemini-cli
 
 The installer runs these steps in sequence:
 
-1. **Authenticate** — Validates your API key (or creates an account with `--signup`)
+1. **Authenticate** — Asks whether you're creating a new account. New users sign up with email + password; returning users paste an API key. Skip the question with `--api-key`, `--signup`, `--yes`, or `ULUOPS_API_KEY`.
 2. **MCP config** — Writes tracker and registry server entries to the harness config
 3. **Definitions** — Copies pre-rendered agent definition files
 4. **Metrics hook** — Configures a post-agent hook for automatic run capture (Claude Code and Gemini CLI)
@@ -62,15 +62,9 @@ The installer runs these steps in sequence:
 npx @uluops/setup
 ```
 
-You'll be prompted for your API key (get one at [app.uluops.ai/settings/api-keys](https://app.uluops.ai/settings/api-keys)). Everything else uses smart defaults — no other prompts. See [What it does](#what-it-does) for the full list of changes made.
+Setup will first ask whether you're creating a new UluOps account. Pick **Y** to sign up with an email and password (account + API key created automatically); pick **n** to paste an existing API key from [app.uluops.ai/settings/api-keys](https://app.uluops.ai/settings/api-keys). Everything else uses smart defaults — no other prompts. See [What it does](#what-it-does) for the full list of changes made.
 
-**New to UluOps?** Create an account without leaving the terminal:
-
-```
-npx @uluops/setup --signup
-```
-
-You'll be prompted for email and password. Account + API key are created automatically.
+> The account question is automatically skipped if you've already saved credentials, set `ULUOPS_API_KEY`, or passed `--api-key`/`--yes`/`--signup`. You can also pass `--signup` to skip the question and go straight to signup.
 
 > **🛑 IMPORTANT:** You must restart your harness (e.g., restart Claude Code) after setup to load the new agents and commands.
 
@@ -135,7 +129,11 @@ Validates your current installation against the local manifest and checks API co
 ### Examples
 
 ```bash
-# New user — create account + install in one shot
+# Default — asks "creating a new account?" then either signs you up or
+# prompts for an existing API key
+npx @uluops/setup
+
+# Skip the account question and go straight to signup
 npx @uluops/setup --signup
 
 # Install for OpenCode

package/dist/cli.js

@@ -3,7 +3,7 @@ import { Command } from "commander";
 import chalk from "chalk";
 import { info, printAgentList } from "./lib/display.js";
 import { getVersion } from "./lib/version.js";
-import { resolveHarnessName, listHarnesses, HarnessNotTestedError, } from "./harnesses/index.js";
+import { resolveHarnessName, listHarnesses, detectHarnesses, HarnessNotTestedError, } from "./harnesses/index.js";
 import { runSetup } from "./commands/setup.js";
 import { runUninstall } from "./commands/uninstall.js";
 import { runVerify } from "./commands/verify.js";
@@ -51,8 +51,43 @@ async function main() {
         process.exit(1);
     }
     const scope = opts.scope === "local" ? "local" : "global";
-    // Resolve harness name (supports aliases)
-    const harnessName = resolveHarnessName(opts.harness);
+    // Resolve harness: if --harness was passed explicitly, honor it as-is.
+    // Otherwise auto-detect — single match wins silently, multiple matches
+    // prompt the user, no matches falls back to the default (claude-code)
+    // to preserve the landing-page "just run npx @uluops/setup" promise.
+    const harnessExplicit = program.getOptionValueSource("harness") === "cli";
+    let harnessName;
+    if (harnessExplicit) {
+        harnessName = resolveHarnessName(opts.harness);
+    }
+    else {
+        const detected = detectHarnesses();
+        if (detected.length === 1) {
+            harnessName = detected[0].name;
+            if (harnessName !== "claude-code") {
+                info(chalk.dim(`Detected ${chalk.cyan(detected[0].displayName)} — using as target (pass --harness to override)`));
+            }
+        }
+        else if (detected.length > 1) {
+            const isInteractive = !opts.yes && !opts.apiKey && !process.env["ULUOPS_API_KEY"] && process.stdin.isTTY;
+            if (isInteractive) {
+                const { select } = await import("@inquirer/prompts");
+                harnessName = await select({
+                    message: "Multiple harnesses detected — which one are you setting up?",
+                    choices: detected.map((p) => ({ name: p.displayName, value: p.name })),
+                    default: detected[0].name,
+                });
+                console.log();
+            }
+            else {
+                harnessName = detected[0].name;
+                info(chalk.dim(`Multiple harnesses detected (${detected.map((p) => p.displayName).join(", ")}); defaulting to ${chalk.cyan(detected[0].displayName)} — pass --harness to choose`));
+            }
+        }
+        else {
+            harnessName = resolveHarnessName(opts.harness);
+        }
+    }
     await runSetup({
         apiKey: opts.apiKey,
         signup: opts.signup ?? false,

package/dist/commands/helpers.js

@@ -3,7 +3,7 @@ import { join } from "node:path";
 import { readdir } from "node:fs/promises";
 import { detect } from "../steps/detect.js";
 import { signup } from "../steps/signup.js";
-import { resolveApiKey } from "../steps/auth.js";
+import { resolveApiKey, hasCredentialsFile } from "../steps/auth.js";
 import { installMcp } from "../steps/mcp.js";
 import { installAgents } from "../steps/agents.js";
 import { installCommands } from "../steps/commands.js";
@@ -14,12 +14,49 @@ import { probeHookSupport } from "../lib/settings-merger.js";
 import { findProjectRoot, ASSETS_DIR } from "../lib/paths.js";
 import { getHealthTimeout } from "../lib/health.js";
 import { ok, warn, fail, info } from "../lib/display.js";
+/**
+ * Decide whether to ask the user "Are you creating a new account?".
+ * The prompt is the new-user friction-reducer — it should fire only when
+ * the user has provided no other signal about who they are.
+ *
+ * Skip the prompt when:
+ *  - `--signup` is set (forces signup path)
+ *  - `--api-key` flag is provided (user already has a key)
+ *  - `ULUOPS_API_KEY` env var is set (CI/automation)
+ *  - `--yes` is passed (non-interactive)
+ *  - stdin is not a TTY (piped / background)
+ *  - a credentials file already exists (returning user)
+ */
+async function shouldPromptForAccount(opts) {
+    if (opts.signup)
+        return false;
+    if (opts.apiKey)
+        return false;
+    if (process.env["ULUOPS_API_KEY"])
+        return false;
+    if (opts.yes)
+        return false;
+    if (!process.stdin.isTTY)
+        return false;
+    if (await hasCredentialsFile())
+        return false;
+    return true;
+}
 /** Resolve API key via flag, env, file, signup, or interactive prompt. Returns env detection + key. */
 export async function initContext(opts) {
     const env = await detect();
     let apiKey;
+    let creatingAccount = opts.signup;
+    if (!opts.signup && (await shouldPromptForAccount(opts))) {
+        const { confirm } = await import("@inquirer/prompts");
+        creatingAccount = await confirm({
+            message: "Are you creating a new UluOps account?",
+            default: true,
+        });
+        console.log();
+    }
     try {
-        if (opts.signup) {
+        if (creatingAccount) {
             info("Create your UluOps account\n");
             const auth = await signup();
             apiKey = auth.apiKey;

package/dist/harnesses/opencode.js

@@ -47,23 +47,23 @@ class OpenCodeMcpConfig {
     merge(config, apiKey) {
         const raw = config["mcp"];
         const existing = (typeof raw === "object" && raw !== null ? raw : {});
+        // Backend URLs resolved by @uluops/ops-mcp and @uluops/registry-mcp via
+        // their bundled SDKs. See lib/config-merger.ts for rationale.
         const tracker = {
             type: "local",
-            command: ["npx", "-y", "uluops-tracker-mcp-client"],
+            command: ["npx", "-y", "@uluops/ops-mcp"],
             enabled: true,
             timeout: 30000,
             environment: {
-                ULUOPS_BASE_URL: "https://api.uluops.ai/api/v1",
                 ULUOPS_API_KEY: apiKey,
             },
         };
         const registry = {
             type: "local",
-            command: ["npx", "-y", "uluops-registry-mcp-client"],
+            command: ["npx", "-y", "@uluops/registry-mcp"],
             enabled: true,
             timeout: 30000,
             environment: {
-                ULUOPS_REGISTRY_URL: "https://api.uluops.ai/api/v1/registry",
                 ULUOPS_API_KEY: apiKey,
             },
         };

package/dist/lib/config-merger.js

@@ -1,6 +1,6 @@
 import { readFile } from "node:fs/promises";
 import { atomicWrite } from "./atomic-write.js";
-const MCP_PACKAGES = ["uluops-tracker-mcp-client", "uluops-registry-mcp-client"];
+const MCP_PACKAGES = ["@uluops/ops-mcp", "@uluops/registry-mcp"];
 /** Check whether the UluOps MCP client packages exist on the npm registry. Returns lists of available and missing packages. */
 export async function checkMcpPackageAvailability() {
     const available = [];
@@ -49,24 +49,26 @@ export async function readConfig(path) {
 export function mergeUluopsMcp(config, apiKey, trust = false) {
     const existing = config.mcpServers ?? {};
     const trustField = trust ? { trust: true } : {};
+    // Backend URLs are resolved by the respective MCP servers (@uluops/ops-mcp
+    // and @uluops/registry-mcp) against their bundled SDKs. Stamping
+    // ULUOPS_BASE_URL / ULUOPS_REGISTRY_URL here would override that resolution
+    // with a value that could go stale if production endpoints ever shift.
     return {
         ...config,
         mcpServers: {
             ...existing,
             "uluops-tracker": {
                 command: "npx",
-                args: ["-y", "uluops-tracker-mcp-client"],
+                args: ["-y", "@uluops/ops-mcp"],
                 env: {
-                    ULUOPS_BASE_URL: "https://api.uluops.ai/api/v1",
                     ULUOPS_API_KEY: apiKey,
                 },
                 ...trustField,
             },
             "uluops-registry": {
                 command: "npx",
-                args: ["-y", "uluops-registry-mcp-client"],
+                args: ["-y", "@uluops/registry-mcp"],
                 env: {
-                    ULUOPS_REGISTRY_URL: "https://api.uluops.ai/api/v1/registry",
                     ULUOPS_API_KEY: apiKey,
                 },
                 ...trustField,

package/dist/steps/auth.d.ts

@@ -2,6 +2,12 @@ export interface AuthResult {
     apiKey: string;
     email: string | null;
 }
+/**
+ * Returns true if a credentials file exists at the default path.
+ * Used by the setup flow to skip the "new account?" prompt for returning users.
+ * Existence-only — does not validate the file's shape or contents.
+ */
+export declare function hasCredentialsFile(): Promise<boolean>;
 /**
  * Resolve API key from flags, env, credentials file, or interactive prompt.
  */

package/dist/steps/auth.js

@@ -1,9 +1,26 @@
-import { readFile } from "node:fs/promises";
+import { readFile, access } from "node:fs/promises";
 import { join } from "node:path";
 import { homedir } from "node:os";
 function getKeyPrefix() {
     return process.env["ULUOPS_KEY_PREFIX"] ?? "ulr_";
 }
+function credentialsPath() {
+    return join(homedir(), ".uluops", "credentials.json");
+}
+/**
+ * Returns true if a credentials file exists at the default path.
+ * Used by the setup flow to skip the "new account?" prompt for returning users.
+ * Existence-only — does not validate the file's shape or contents.
+ */
+export async function hasCredentialsFile() {
+    try {
+        await access(credentialsPath());
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 /**
  * Resolve API key from flags, env, credentials file, or interactive prompt.
  */
@@ -48,7 +65,7 @@ export async function resolveApiKey(options) {
     return { apiKey, email: null };
 }
 async function readCredentialsFile() {
-    const credsPath = join(homedir(), ".uluops", "credentials.json");
+    const credsPath = credentialsPath();
     let raw;
     try {
         raw = await readFile(credsPath, "utf-8");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uluops/setup",
-  "version": "0.6.0",
+  "version": "0.6.4",
   "description": "Zero-friction installer for UluOps agentic harnesses",
   "license": "MIT",
   "repository": {