@test-bro/cli 0.1.0 → 0.1.2

package/README.md

@@ -7,18 +7,17 @@ Command-line interface for AI-powered browser testing. Generate, run, and manage
 ### Global Installation (Recommended)
 
 ```bash
-npm install -g testbro-cli
+npm install -g @test-bro/cli
 ```
 
 ### Local Development
 
 ```bash
-cd apps/cli
-pnpm install
-pnpm build
-pnpm link --global
+npm install -g @test-bro/cli
 ```
 
+For local CLI validation workflows (unit tests, dist smoke tests, and `npm pack` artifact testing), see [`local-cli-testing.md`](./local-cli-testing.md).
+
 ## Quick Start
 
 ### 1. Authenticate
@@ -143,12 +142,12 @@ Authenticate with TestBro API.
 testbro login --token tb_live_xxxxx
 
 # Custom API URL
-testbro login --token tb_live_xxxxx --url https://api.testbro.dev
+testbro login --token tb_live_xxxxx --url https://testbro.dev
 ```
 
 **Options:**
 - `-t, --token <token>`: API token from your TestBro account
-- `-u, --url <url>`: API URL (default: http://localhost:3024)
+- `-u, --url <url>`: API URL (default: https://testbro.dev)
 
 #### `testbro logout`
 
@@ -405,7 +404,7 @@ TestBro Configuration
 
 User Config (~/.testbro/config.json)
   Path: /Users/name/.testbro/config.json
-  API URL: http://localhost:3024
+  API URL: https://testbro.dev
   Authenticated: Yes
   Active Project: proj_abc123
 
@@ -465,7 +464,7 @@ Stores user-level settings and authentication.
 
 ```json
 {
-  "apiUrl": "http://localhost:3024",
+  "apiUrl": "https://testbro.dev",
   "token": "tb_live_xxxxx",
   "activeProjectId": "proj_abc123"
 }
@@ -530,7 +529,7 @@ TEST_USERNAME=testuser@example.com
 TEST_PASSWORD=SecureP@ssw0rd
 
 # API URL override
-TESTBRO_API_URL=https://api.testbro.dev
+TESTBRO_API_URL=https://testbro.dev
 ```
 
 ## Session Continuity
@@ -686,7 +685,7 @@ jobs:
           node-version: 18
 
       - name: Install TestBro CLI
-        run: npm install -g testbro-cli
+        run: npm install -g @test-bro/cli
 
       - name: Run Tests
         env:
@@ -708,7 +707,7 @@ jobs:
 test:
   image: node:18
   script:
-    - npm install -g testbro-cli
+    - npm install -g @test-bro/cli
     - testbro run --project $PROJECT_ID --format json > results.json
   artifacts:
     paths:
@@ -830,8 +829,8 @@ pnpm install
 # Build
 pnpm build
 
-# Link globally for testing
-pnpm link --global
+# Install official CLI globally
+npm install -g @test-bro/cli
 
 # Run locally
 pnpm start -- run --help

package/dist/index.js

@@ -1,5 +1,4 @@
 #!/usr/bin/env node
-#!/usr/bin/env node
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
@@ -181,7 +180,7 @@ var init_config = __esm({
   "src/config.ts"() {
     "use strict";
     DEFAULT_CONFIG = {
-      apiUrl: "https://www.testbro.dev"
+      apiUrl: "https://testbro.dev"
     };
   }
 });
@@ -339,7 +338,7 @@ function mergeWithCliOptions(projectConfig, cliOptions) {
   return merged;
 }
 function getProjectConfigSummary() {
-  const { config, path: path9, error } = loadProjectConfig();
+  const { config, path: path10, error } = loadProjectConfig();
   let tokenSource = null;
   let token = null;
   if (process.env.TEST_BRO_TOKEN) {
@@ -357,7 +356,7 @@ function getProjectConfigSummary() {
     }
   }
   return {
-    projectConfigPath: path9,
+    projectConfigPath: path10,
     projectConfig: config,
     error,
     token,
@@ -393,7 +392,8 @@ var init_project_config = __esm({
       steps: z.array(authStepSchema),
       credentials: z.record(z.string(), z.string()).optional(),
       storageStatePath: z.string().optional(),
-      maxAge: z.number().optional()
+      maxAge: z.number().optional(),
+      waitForUrl: z.string().optional()
     });
     projectConfigSchema = z.object({
       $schema: z.string().optional(),
@@ -439,7 +439,7 @@ var init_project_config = __esm({
 // src/index.ts
 import "dotenv/config";
 import { Command } from "commander";
-import chalk28 from "chalk";
+import chalk29 from "chalk";
 
 // src/commands/login.ts
 import chalk3 from "chalk";
@@ -616,6 +616,7 @@ async function apiRequestCore(endpoint, options = {}, authToken, requireAuth = t
   };
   if (token) {
     headers.Authorization = `Bearer ${token}`;
+    headers["x-api-key"] = token;
   }
   const response = await fetch(url, {
     ...options,
@@ -816,40 +817,50 @@ async function uploadArtifacts(runId, options) {
   }
   const token = getToken();
   if (!token) {
-    return {};
+    throw new Error("No API token found for artifact upload");
   }
-  try {
-    const apiUrl = getApiUrl();
-    const url = `${apiUrl}/api/runs/${runId}/artifacts`;
-    const formData = new FormData();
-    if (videoPath) {
-      const videoBuffer = fs2.readFileSync(videoPath);
-      const videoType = videoPath.endsWith(".mp4") ? "video/mp4" : "video/webm";
-      const videoBlob = new Blob([videoBuffer], { type: videoType });
-      const videoFileName = videoPath.split("/").pop() || "video.webm";
-      formData.append("video", videoBlob, videoFileName);
-    }
-    if (tracePath) {
-      const traceBuffer = fs2.readFileSync(tracePath);
-      const traceBlob = new Blob([traceBuffer], { type: "application/zip" });
-      const traceFileName = tracePath.split("/").pop() || "trace.zip";
-      formData.append("trace", traceBlob, traceFileName);
-    }
-    const response = await fetch(url, {
-      method: "POST",
-      headers: {
-        Authorization: `Bearer ${token}`
-      },
-      body: formData
-    });
-    if (!response.ok) {
-      return {};
+  const apiUrl = getApiUrl();
+  const url = `${apiUrl}/api/runs/${runId}/artifacts`;
+  const formData = new FormData();
+  if (videoPath) {
+    const videoBuffer = fs2.readFileSync(videoPath);
+    const videoType = videoPath.endsWith(".mp4") ? "video/mp4" : "video/webm";
+    const videoBlob = new Blob([videoBuffer], { type: videoType });
+    const videoFileName = videoPath.split("/").pop() || "video.webm";
+    formData.append("video", videoBlob, videoFileName);
+  }
+  if (tracePath) {
+    const traceBuffer = fs2.readFileSync(tracePath);
+    const traceBlob = new Blob([traceBuffer], { type: "application/zip" });
+    const traceFileName = tracePath.split("/").pop() || "trace.zip";
+    formData.append("trace", traceBlob, traceFileName);
+  }
+  const response = await fetch(url, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${token}`
+    },
+    body: formData
+  });
+  if (!response.ok) {
+    let details = "";
+    try {
+      const contentType = response.headers.get("content-type") || "";
+      if (contentType.includes("application/json")) {
+        const errData = await response.json();
+        details = errData.error || JSON.stringify(errData.details || errData.data || "");
+      } else {
+        details = await response.text();
+      }
+    } catch {
+      details = "";
     }
-    const data = await response.json();
-    return data.data || {};
-  } catch {
-    return {};
+    throw new Error(
+      `Artifact upload failed (${response.status}${response.statusText ? ` ${response.statusText}` : ""})${details ? `: ${details}` : ""}`
+    );
   }
+  const data = await response.json();
+  return data.data || {};
 }
 async function listFeatures(projectId) {
   return apiRequest(`/api/projects/${projectId}/features`);
@@ -1034,10 +1045,10 @@ function extractValidationHints(details) {
       for (const issue of obj.issues) {
         if (typeof issue === "object" && issue !== null) {
           const i = issue;
-          const path9 = Array.isArray(i.path) ? i.path.join(".") : String(i.path ?? "");
+          const path10 = Array.isArray(i.path) ? i.path.join(".") : String(i.path ?? "");
           const message = typeof i.message === "string" ? i.message : "";
-          if (path9 && message) {
-            hints.push(`${path9}: ${message}`);
+          if (path10 && message) {
+            hints.push(`${path10}: ${message}`);
           } else if (message) {
             hints.push(message);
           }
@@ -1419,7 +1430,7 @@ async function quickstartCommand(options = {}) {
     console.log("");
     console.log(chalk5.yellow("  Please authenticate first:"));
     console.log("");
-    console.log(chalk5.dim("  1. Go to ") + chalk5.cyan("http://localhost:3024/dashboard/settings"));
+    console.log(chalk5.dim("  1. Go to ") + chalk5.cyan("https://testbro.dev/dashboard/settings"));
     console.log(chalk5.dim("  2. Create an API token"));
     console.log(chalk5.dim("  3. Run: ") + chalk5.cyan("testbro init") + chalk5.dim(" (or testbro login --token <your-token>)"));
     console.log("");
@@ -1434,7 +1445,7 @@ async function quickstartCommand(options = {}) {
     spinner.fail("Token is invalid or expired");
     console.log("");
     console.log(chalk5.yellow("  Please re-authenticate:"));
-    console.log(chalk5.dim("  1. Go to ") + chalk5.cyan("http://localhost:3024/dashboard/settings"));
+    console.log(chalk5.dim("  1. Go to ") + chalk5.cyan("https://testbro.dev/dashboard/settings"));
     console.log(chalk5.dim("  2. Create a new API token"));
     console.log(chalk5.dim("  3. Run: ") + chalk5.cyan("testbro init") + chalk5.dim(" (or testbro login --token <your-token>)"));
     console.log("");
@@ -1875,7 +1886,7 @@ var AuthExecutor = class _AuthExecutor {
         );
         await _AuthExecutor.executeStep(page, resolvedStep);
       }
-      await page.waitForTimeout(2e3);
+      await _AuthExecutor.waitForAuthComplete(page, authConfig, loginUrl);
       await context.storageState({ path: statePath });
       return statePath;
     } finally {
@@ -2034,6 +2045,42 @@ var AuthExecutor = class _AuthExecutor {
       }
     }
   }
+  /**
+   * Wait for the authentication flow to fully complete after all steps.
+   *
+   * Handles redirect-based auth flows (e.g., NextAuth v5 server actions)
+   * where the session cookie is set during a redirect chain, not on the
+   * initial response. Uses three strategies in order:
+   *
+   * 1. If `waitForUrl` is configured, wait for that specific URL pattern
+   * 2. Otherwise, detect URL change from the login page (redirect completed)
+   * 3. Wait for network idle to ensure all Set-Cookie headers are processed
+   */
+  static async waitForAuthComplete(page, authConfig, loginUrl) {
+    const waitTimeout = 15e3;
+    if (authConfig.waitForUrl) {
+      try {
+        await page.waitForURL(authConfig.waitForUrl, {
+          timeout: waitTimeout,
+          waitUntil: "load"
+        });
+      } catch {
+      }
+    } else {
+      try {
+        await page.waitForURL(
+          (url) => url.toString() !== loginUrl,
+          { timeout: waitTimeout, waitUntil: "load" }
+        );
+      } catch {
+      }
+    }
+    try {
+      await page.waitForLoadState("networkidle", { timeout: 5e3 });
+    } catch {
+    }
+    await page.waitForTimeout(1e3);
+  }
   /**
    * Delete the cached storage state file.
    * @param statePath - Path to the storage state file
@@ -3434,6 +3481,17 @@ You are a GOAL-ORIENTED test agent. Each step describes an INTENT, not a rigid i
 - Always explain your reasoning when deviating from the original step description
 - If an element is below the fold, suggest scrolling first
 
+## Intent Safety Guardrails
+- NEVER click or fill a semantically unrelated element just to make progress.
+- If the requested target is not present, do NOT guess a random alternative action.
+- Preserve intent class when adapting. Examples:
+  - form input intent -> editable field
+  - navigation intent -> relevant nav control/link
+  - confirmation intent -> intended submit/confirm action
+- Prefer this fallback order when target is missing: **scroll -> wait -> navigate/click a clearly relevant entry point for the SAME intent class**.
+- Before acting, validate evidence from Available Elements and visible UI cues (role, label, testId, text). If evidence is weak or ambiguous, lower confidence or choose wait/scroll instead of a risky click.
+- If no relevant action is possible on the current page, return confidence 0 and explain why.
+
 Always respond with valid JSON only. Do not include any other text.`;
 var MAX_MEMORY_ENTRIES = 10;
 function formatStepMemory(memory) {
@@ -3497,7 +3555,9 @@ function generateFillPrompt(fieldDescription, textToEnter, availableElements, me
 Then type: "${textToEnter}"`,
     `IMPORTANT: For fill actions, you MUST target an <input>, <textarea>, or <select> element \u2014 NOT a link, button, div, or card.
 If a dialog or modal is open, look for input fields INSIDE the dialog, not behind it.
-Identify the input field and provide coordinates to click it before typing. Look for data-testid, name, or placeholder attributes for the best selector.`,
+Identify the input field and provide coordinates to click it before typing. Look for data-testid, name, or placeholder attributes for the best selector.
+If no editable field for this intent is visible, do NOT fill a non-input element.
+If input is unavailable in current state, choose a preparatory step that keeps the same intent class (e.g., open relevant form/screen), otherwise return confidence 0.`,
     availableElements,
     memoryContext
   );
@@ -3571,6 +3631,9 @@ Consider:
 - You may need to scroll to find the element
 - A modal or overlay may be blocking \u2014 close it first
 - The page may be in a different state than expected \u2014 adapt accordingly
+- Preserve intent class when adapting (input -> input, navigation -> navigation, assertion -> evidence)
+- Prefer preparatory actions (scroll/wait/open relevant surface) before risky substitutions
+- NEVER use an unrelated element as a substitute action
 - If the intent is truly impossible on this page, set confidence to 0
 
 Respond with the action you would take to achieve the intent.`
@@ -8349,28 +8412,42 @@ async function runTestExecution(options) {
       if (isPretty) {
         if (uploadResult.videoUrl) {
           log.plain(`${chalk16.bold("Video URL:")} ${chalk16.cyan(uploadResult.videoUrl)}`);
+        } else if (videoPath) {
+          log.warn("Video upload completed without a Video URL. Keeping local file.");
+          log.dim(`Local video: ${videoPath}`);
         }
         if (uploadResult.traceUrl) {
           log.plain(`${chalk16.bold("Trace URL:")} ${chalk16.cyan(uploadResult.traceUrl)}`);
+        } else if (tracePath) {
+          log.warn("Trace upload completed without a Trace URL. Keeping local file.");
+          log.dim(`Local trace: ${tracePath}`);
         }
       }
-      if (videoPath) {
+      if (videoPath && uploadResult.videoUrl) {
         try {
           fs7.unlinkSync(videoPath);
           fs7.rmSync(path7.dirname(videoPath), { recursive: true, force: true });
         } catch {
         }
       }
-      if (tracePath) {
+      if (tracePath && uploadResult.traceUrl) {
         try {
           fs7.unlinkSync(tracePath);
           fs7.rmSync(path7.dirname(tracePath), { recursive: true, force: true });
         } catch {
         }
       }
-    } catch {
+    } catch (error) {
       if (isPretty) {
-        log.dim("  Warning: Failed to upload recordings");
+        const message = error instanceof Error ? error.message : String(error);
+        log.warn("Failed to upload recordings");
+        log.dim(`Reason: ${message}`);
+        if (videoPath) {
+          log.dim(`Local video kept: ${videoPath}`);
+        }
+        if (tracePath) {
+          log.dim(`Local trace kept: ${tracePath}`);
+        }
       }
     }
   }
@@ -9879,10 +9956,245 @@ function formatStatus2(status) {
   }
 }
 
+// src/commands/upgrade.ts
+import { execSync } from "child_process";
+import chalk28 from "chalk";
+
+// package.json
+var package_default = {
+  name: "@test-bro/cli",
+  publishConfig: {
+    access: "public"
+  },
+  version: "0.1.1",
+  description: "TestBro CLI - AI-powered browser testing from your terminal",
+  type: "module",
+  bin: {
+    testbro: "dist/index.js"
+  },
+  files: [
+    "dist"
+  ],
+  engines: {
+    node: ">=18"
+  },
+  keywords: [
+    "testing",
+    "browser-testing",
+    "playwright",
+    "ai-testing",
+    "test-automation",
+    "e2e",
+    "qa"
+  ],
+  repository: {
+    type: "git",
+    url: "git+https://github.com/chernobelenkiy/test-bro.git",
+    directory: "apps/cli"
+  },
+  license: "MIT",
+  scripts: {
+    build: "tsup",
+    dev: "tsup --watch",
+    typecheck: "tsc --noEmit",
+    lint: "eslint src/",
+    test: "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  dependencies: {
+    commander: "^12.1.0",
+    chalk: "^5.3.0",
+    ora: "^8.1.1",
+    dotenv: "^16.4.7",
+    playwright: "^1.40.0",
+    zod: "^3.24.1"
+  },
+  devDependencies: {
+    "@testbro/core": "workspace:*",
+    "@testbro/runner": "workspace:*",
+    "@testbro/ai-agent": "workspace:*",
+    "@types/node": "^22.10.2",
+    "@vitest/coverage-v8": "^2.1.0",
+    tsup: "^8.3.5",
+    typescript: "^5.7.2",
+    vitest: "^2.1.0"
+  }
+};
+
+// src/version.ts
+var CLI_VERSION = package_default.version;
+
+// src/version-check.ts
+init_config();
+import * as fs10 from "fs";
+import * as path9 from "path";
+var CACHE_FILE_NAME = "version-check.json";
+var CACHE_TTL_MS = 24 * 60 * 60 * 1e3;
+var NPM_REGISTRY_URL = "https://registry.npmjs.org/@test-bro/cli/latest";
+var FETCH_TIMEOUT_MS = 5e3;
+function getCachePath() {
+  return path9.join(getConfigDir(), CACHE_FILE_NAME);
+}
+function readCache() {
+  try {
+    const cachePath = getCachePath();
+    if (!fs10.existsSync(cachePath)) {
+      return null;
+    }
+    const raw = fs10.readFileSync(cachePath, "utf-8");
+    const data = JSON.parse(raw);
+    const age = Date.now() - new Date(data.checkedAt).getTime();
+    if (age > CACHE_TTL_MS) {
+      return null;
+    }
+    return data;
+  } catch {
+    return null;
+  }
+}
+function writeCache(latestVersion) {
+  try {
+    const configDir = getConfigDir();
+    if (!fs10.existsSync(configDir)) {
+      fs10.mkdirSync(configDir, { recursive: true, mode: 448 });
+    }
+    const data = {
+      latestVersion,
+      checkedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    fs10.writeFileSync(getCachePath(), JSON.stringify(data, null, 2), {
+      encoding: "utf-8",
+      mode: 384
+    });
+  } catch {
+  }
+}
+async function fetchLatestVersion() {
+  try {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+    const response = await fetch(NPM_REGISTRY_URL, {
+      signal: controller.signal,
+      headers: { Accept: "application/json" }
+    });
+    clearTimeout(timeout);
+    if (!response.ok) {
+      return null;
+    }
+    const data = await response.json();
+    return data.version ?? null;
+  } catch {
+    return null;
+  }
+}
+function compareSemver(a, b) {
+  const pa = a.split(".").map(Number);
+  const pb = b.split(".").map(Number);
+  const len = Math.max(pa.length, pb.length);
+  for (let i = 0; i < len; i++) {
+    const na = pa[i] ?? 0;
+    const nb = pb[i] ?? 0;
+    if (na < nb) return -1;
+    if (na > nb) return 1;
+  }
+  return 0;
+}
+async function checkForUpdate(currentVersion) {
+  const cached = readCache();
+  if (cached) {
+    if (compareSemver(currentVersion, cached.latestVersion) < 0) {
+      return cached.latestVersion;
+    }
+    return null;
+  }
+  const latest = await fetchLatestVersion();
+  if (!latest) {
+    return null;
+  }
+  writeCache(latest);
+  if (compareSemver(currentVersion, latest) < 0) {
+    return latest;
+  }
+  return null;
+}
+function startVersionCheck(currentVersion) {
+  const checkPromise = checkForUpdate(currentVersion).catch(() => null);
+  return async () => {
+    try {
+      const latestVersion = await checkPromise;
+      if (latestVersion) {
+        const chalk30 = (await import("chalk")).default;
+        console.log(
+          chalk30.yellow(
+            `
+Update available: ${currentVersion} \u2192 ${latestVersion}. Run \`testbro upgrade\` to update.`
+          )
+        );
+      }
+    } catch {
+    }
+  };
+}
+
+// src/commands/upgrade.ts
+async function upgradeCommand() {
+  console.log(chalk28.bold("TestBro CLI Upgrade"));
+  console.log("");
+  console.log(`  Current version: ${chalk28.dim(CLI_VERSION)}`);
+  console.log(chalk28.dim("  Checking npm registry..."));
+  const latestVersion = await fetchLatestVersion();
+  if (!latestVersion) {
+    console.log(
+      chalk28.red(
+        "  Failed to check npm registry. Please check your internet connection."
+      )
+    );
+    process.exit(1);
+  }
+  console.log(`  Latest version:  ${chalk28.green(latestVersion)}`);
+  console.log("");
+  if (compareSemver(CLI_VERSION, latestVersion) >= 0) {
+    console.log(chalk28.green("  You are already on the latest version."));
+    return;
+  }
+  console.log(
+    chalk28.yellow(
+      `  Upgrading ${CLI_VERSION} \u2192 ${latestVersion}...`
+    )
+  );
+  console.log("");
+  try {
+    execSync("npm install -g @test-bro/cli@latest", {
+      stdio: "inherit"
+    });
+    writeCache(latestVersion);
+    console.log("");
+    console.log(
+      chalk28.green(
+        `  Successfully upgraded to @test-bro/cli@${latestVersion}`
+      )
+    );
+  } catch {
+    console.log("");
+    console.log(
+      chalk28.red(
+        "  Upgrade failed. You may need to run with sudo or fix npm permissions."
+      )
+    );
+    console.log(
+      chalk28.dim(
+        "  Try: sudo npm install -g @test-bro/cli@latest"
+      )
+    );
+    process.exit(1);
+  }
+}
+
 // src/index.ts
 var program = new Command();
-program.name("testbro").description("AI-powered browser testing from your terminal").version("0.1.0");
-program.command("login").description("Authenticate with TestBro using an API token").argument("[email]", "Your email address (deprecated - use --token instead)").option("-t, --token <token>", "API token for authentication").option("-u, --url <url>", "API URL (default: http://localhost:3024)").action(async (email, options) => {
+program.name("testbro").description("AI-powered browser testing from your terminal").version(CLI_VERSION);
+program.command("login").description("Authenticate with TestBro using an API token").argument("[email]", "Your email address (deprecated - use --token instead)").option("-t, --token <token>", "API token for authentication").option("-u, --url <url>", "API URL (default: https://testbro.dev)").action(async (email, options) => {
   try {
     await loginCommand(email, { token: options.token, url: options.url });
   } catch (error) {
@@ -9985,7 +10297,7 @@ program.command("generate").description("Generate test cases from a file or desc
 program.command("run").description("Run tests against a URL").option("-u, --url <url>", "Target URL to test (or use baseUrl from test-bro.config.json)").option("--file <path>", "Path to file (AC/PRD) to generate and run tests from").option("-d, --description <text>", "Feature description to test").option("-p, --project <id>", "Project ID to use test cases from (overrides active)").option("-t, --test-case <id>", "Run specific test case only").option("-m, --mode <mode>", "Execution mode: selector (default), ai, or hybrid", "selector").option("--headed", "Run browser in headed mode (visible)", false).option("--remote", "Run tests on remote staging environment", false).option("-f, --format <format>", "Output format: pretty or json", "pretty").option("-v, --verbose", "Show verbose output", false).option("--timeout <ms>", "Timeout per step in milliseconds", "30000").option("--learn-selectors", "Learn selectors from AI actions", false).option("--yes", "Auto-confirm selector learning", false).option("--no-dedup", "Skip deduplication check when using --file").option("--auto-merge", "Auto-apply smart merge without prompting when using --file").option("--record-video", "Record video of the test execution", false).option("--record-trace", "Capture Playwright trace for debugging", false).option("-e, --env <name>", "Use a named environment (fetches baseUrl from API)").option("--credential <name>", "Use a named credential from the vault").option("--no-sequential", "Run test cases independently (re-navigate for each)").action(async (options) => {
   if (options.url && !validateUrl(options.url)) {
     displayError("Invalid URL format", `Provided URL: ${options.url}`);
-    console.log(chalk28.dim('  Example: testbro run --url https://example.com --description "..."'));
+    console.log(chalk29.dim('  Example: testbro run --url https://example.com --description "..."'));
     process.exit(1);
   }
   if (options.description) {
@@ -10231,6 +10543,17 @@ releasesCmd.command("unpublish").description("Unpublish a release note (revert t
     process.exit(1);
   }
 });
+program.command("upgrade").description("Upgrade TestBro CLI to the latest version").action(async () => {
+  try {
+    await upgradeCommand();
+  } catch (error) {
+    if (error instanceof Error) {
+      displayError(error.message);
+    }
+    printErrorHints(error);
+    process.exit(1);
+  }
+});
 var configCmd = program.command("config").description("Show or update configuration");
 function displayConfig() {
   const { getConfigSummary: getConfigSummary2 } = (init_config(), __toCommonJS(config_exports));
@@ -10241,72 +10564,72 @@ function displayConfig() {
   const userConfig = getConfigSummary2();
   const projectConfigInfo = getProjectConfigSummary2();
   console.log("");
-  console.log(chalk28.bold("TestBro Configuration"));
+  console.log(chalk29.bold("TestBro Configuration"));
   console.log("");
-  console.log(chalk28.underline("User Config") + chalk28.dim(` (~/.testbro/config.json)`));
-  console.log(`  ${chalk28.dim("Path:")} ${userConfig.configPath}`);
-  console.log(`  ${chalk28.dim("API URL:")} ${userConfig.apiUrl}`);
+  console.log(chalk29.underline("User Config") + chalk29.dim(` (~/.testbro/config.json)`));
+  console.log(`  ${chalk29.dim("Path:")} ${userConfig.configPath}`);
+  console.log(`  ${chalk29.dim("API URL:")} ${userConfig.apiUrl}`);
   console.log(
-    `  ${chalk28.dim("Authenticated:")} ${userConfig.authenticated ? chalk28.green("Yes") : chalk28.yellow("No")}`
+    `  ${chalk29.dim("Authenticated:")} ${userConfig.authenticated ? chalk29.green("Yes") : chalk29.yellow("No")}`
   );
   if (userConfig.activeProjectId) {
-    console.log(`  ${chalk28.dim("Active Project:")} ${userConfig.activeProjectId}`);
+    console.log(`  ${chalk29.dim("Active Project:")} ${userConfig.activeProjectId}`);
   }
   console.log("");
-  console.log(chalk28.underline("Project Config") + chalk28.dim(` (test-bro.config.json)`));
+  console.log(chalk29.underline("Project Config") + chalk29.dim(` (test-bro.config.json)`));
   if (projectConfigInfo.projectConfigPath) {
-    console.log(`  ${chalk28.dim("Path:")} ${projectConfigInfo.projectConfigPath}`);
+    console.log(`  ${chalk29.dim("Path:")} ${projectConfigInfo.projectConfigPath}`);
     if (projectConfigInfo.error) {
-      console.log(`  ${chalk28.red("Error:")} ${projectConfigInfo.error}`);
+      console.log(`  ${chalk29.red("Error:")} ${projectConfigInfo.error}`);
     } else if (projectConfigInfo.projectConfig) {
       const pc = projectConfigInfo.projectConfig;
       if (pc.baseUrl) {
-        console.log(`  ${chalk28.dim("Base URL:")} ${pc.baseUrl}`);
+        console.log(`  ${chalk29.dim("Base URL:")} ${pc.baseUrl}`);
       }
       if (pc.environment) {
-        console.log(`  ${chalk28.dim("Environment:")} ${pc.environment}`);
+        console.log(`  ${chalk29.dim("Environment:")} ${pc.environment}`);
       }
       if (pc.mode) {
-        console.log(`  ${chalk28.dim("Mode:")} ${pc.mode}`);
+        console.log(`  ${chalk29.dim("Mode:")} ${pc.mode}`);
       }
       if (pc.timeout) {
-        console.log(`  ${chalk28.dim("Timeout:")} ${pc.timeout}ms`);
+        console.log(`  ${chalk29.dim("Timeout:")} ${pc.timeout}ms`);
       }
       if (pc.headed !== void 0) {
-        console.log(`  ${chalk28.dim("Headed:")} ${pc.headed}`);
+        console.log(`  ${chalk29.dim("Headed:")} ${pc.headed}`);
       }
       if (pc.projectId) {
-        console.log(`  ${chalk28.dim("Project ID:")} ${pc.projectId}`);
+        console.log(`  ${chalk29.dim("Project ID:")} ${pc.projectId}`);
       }
       const credNames = getCredentialNames2(pc);
       if (credNames.length > 0) {
-        console.log(`  ${chalk28.dim("Credentials:")} ${credNames.join(", ")}`);
+        console.log(`  ${chalk29.dim("Credentials:")} ${credNames.join(", ")}`);
       }
       if (pc.deduplication) {
         const dedupEnabled = pc.deduplication.enabled !== false;
         const autoMerge = pc.deduplication.autoMerge === true;
-        console.log(`  ${chalk28.dim("Deduplication:")} ${dedupEnabled ? chalk28.green("enabled") : chalk28.yellow("disabled")}${autoMerge ? chalk28.dim(" (auto-merge)") : ""}`);
+        console.log(`  ${chalk29.dim("Deduplication:")} ${dedupEnabled ? chalk29.green("enabled") : chalk29.yellow("disabled")}${autoMerge ? chalk29.dim(" (auto-merge)") : ""}`);
       }
     }
   } else {
-    console.log(`  ${chalk28.dim("Not found")}`);
+    console.log(`  ${chalk29.dim("Not found")}`);
   }
   console.log("");
-  console.log(chalk28.underline("Authentication"));
+  console.log(chalk29.underline("Authentication"));
   if (projectConfigInfo.token) {
     const maskedToken = projectConfigInfo.token.length > 8 ? `${projectConfigInfo.token.slice(0, 4)}...${projectConfigInfo.token.slice(-4)}` : "****";
-    const sourceLabel = projectConfigInfo.tokenSource === "env" ? chalk28.cyan("(from TEST_BRO_TOKEN env)") : chalk28.dim("(from user config)");
-    console.log(`  ${chalk28.dim("Token:")} ${maskedToken} ${sourceLabel}`);
+    const sourceLabel = projectConfigInfo.tokenSource === "env" ? chalk29.cyan("(from TEST_BRO_TOKEN env)") : chalk29.dim("(from user config)");
+    console.log(`  ${chalk29.dim("Token:")} ${maskedToken} ${sourceLabel}`);
   } else {
-    console.log(`  ${chalk28.yellow("No token configured")}`);
-    console.log(chalk28.dim("  Set via: testbro init (or testbro login --token <token>)"));
-    console.log(chalk28.dim("  Or set TEST_BRO_TOKEN environment variable"));
+    console.log(`  ${chalk29.yellow("No token configured")}`);
+    console.log(chalk29.dim("  Set via: testbro init (or testbro login --token <token>)"));
+    console.log(chalk29.dim("  Or set TEST_BRO_TOKEN environment variable"));
   }
   if (projectConfigInfo.openRouterApiKey) {
     const maskedKey = projectConfigInfo.openRouterApiKey.length > 8 ? `${projectConfigInfo.openRouterApiKey.slice(0, 6)}...${projectConfigInfo.openRouterApiKey.slice(-4)}` : "****";
-    console.log(`  ${chalk28.dim("OpenRouter API Key:")} ${maskedKey} ${chalk28.cyan("(from OPENROUTER_API_KEY env)")}`);
+    console.log(`  ${chalk29.dim("OpenRouter API Key:")} ${maskedKey} ${chalk29.cyan("(from OPENROUTER_API_KEY env)")}`);
   } else {
-    console.log(`  ${chalk28.dim("OpenRouter API Key:")} ${chalk28.yellow("Not set")} ${chalk28.dim("(required for AI mode)")}`);
+    console.log(`  ${chalk29.dim("OpenRouter API Key:")} ${chalk29.yellow("Not set")} ${chalk29.dim("(required for AI mode)")}`);
   }
   console.log("");
 }
@@ -10320,11 +10643,11 @@ configCmd.command("init").description("Create a test-bro.config.json template in
   try {
     const { createConfigFile: createConfigFile2 } = (init_project_config(), __toCommonJS(project_config_exports));
     const configPath = createConfigFile2();
-    console.log(chalk28.green(`Created ${configPath}`));
+    console.log(chalk29.green(`Created ${configPath}`));
     console.log("");
-    console.log(chalk28.dim("Edit this file to configure your project settings."));
-    console.log(chalk28.dim("Note: Never store tokens in this file. Use .env or testbro login."));
-    console.log(chalk28.dim("Tip: Use 'testbro init' for interactive setup with authentication."));
+    console.log(chalk29.dim("Edit this file to configure your project settings."));
+    console.log(chalk29.dim("Note: Never store tokens in this file. Use .env or testbro login."));
+    console.log(chalk29.dim("Tip: Use 'testbro init' for interactive setup with authentication."));
   } catch (error) {
     if (error instanceof Error) {
       displayError(error.message);
@@ -10338,7 +10661,11 @@ configCmd.option("--api-url <url>", "Set the API URL in user config").hook("preA
   if (options.apiUrl) {
     const { setApiUrl: setApiUrl2 } = (init_config(), __toCommonJS(config_exports));
     setApiUrl2(options.apiUrl);
-    console.log(chalk28.green(`API URL updated to: ${options.apiUrl}`));
+    console.log(chalk29.green(`API URL updated to: ${options.apiUrl}`));
   }
 });
+var showVersionNotice = startVersionCheck(CLI_VERSION);
+program.hook("postAction", async () => {
+  await showVersionNotice();
+});
 program.parse();

package/package.json

@@ -3,11 +3,11 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "TestBro CLI - AI-powered browser testing from your terminal",
   "type": "module",
   "bin": {
-    "testbro": "./dist/index.js"
+    "testbro": "dist/index.js"
   },
   "files": [
     "dist"
@@ -26,7 +26,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/chernobelenkiy/test-bro.git",
+    "url": "git+https://github.com/chernobelenkiy/test-bro.git",
     "directory": "apps/cli"
   },
   "license": "MIT",