@vizzly-testing/cli 0.24.1 → 0.25.0

package/dist/plugin-api.js

@@ -9,10 +9,13 @@
  * exposed to plugins to prevent coupling to implementation details.
  */
 
+import { detectBranch, detectCommit, detectCommitMessage, detectPullRequestNumber, generateBuildNameWithGit } from './utils/git.js';
+
 /**
  * Creates a stable plugin services object from the internal services
  *
  * Only exposes:
+ * - git: Git information detection (branch, commit, PR number, etc.)
  * - testRunner: Build lifecycle management (createBuild, finalizeBuild, events)
  * - serverManager: Screenshot server control (start, stop)
  *
@@ -25,6 +28,29 @@ export function createPluginServices(services) {
     serverManager
   } = services;
   return Object.freeze({
+    // Git detection utilities - provides correct git info from CI environments
+    git: Object.freeze({
+      /**
+       * Detect git information for build creation
+       * Handles CI environment variables correctly (GitHub Actions, GitLab, etc.)
+       *
+       * @param {Object} [options] - Detection options
+       * @param {string} [options.buildPrefix] - Prefix for generated build name
+       * @returns {Promise<Object>} Git info: { branch, commit, message, prNumber, buildName }
+       */
+      async detect(options = {}) {
+        let [branch, commit, message] = await Promise.all([detectBranch(), detectCommit(), detectCommitMessage()]);
+        let prNumber = detectPullRequestNumber();
+        let buildName = await generateBuildNameWithGit(options.buildPrefix);
+        return {
+          branch,
+          commit,
+          message,
+          prNumber,
+          buildName
+        };
+      }
+    }),
     testRunner: Object.freeze({
       // EventEmitter methods for build lifecycle events
       once: testRunner.once.bind(testRunner),

package/dist/utils/config-loader.js

@@ -1,7 +1,7 @@
 import { resolve } from 'node:path';
 import { cosmiconfigSync } from 'cosmiconfig';
 import { validateVizzlyConfigWithDefaults } from './config-schema.js';
-import { getApiToken, getApiUrl, getParallelId } from './environment-config.js';
+import { getApiToken, getApiUrl, getBuildName, getParallelId } from './environment-config.js';
 import { getProjectMapping } from './global-config.js';
 import * as output from './output.js';
 const DEFAULT_CONFIG = {
@@ -98,12 +98,17 @@ export async function loadConfig(configPath = null, cliOverrides = {}) {
   // 4. Override with environment variables (higher priority than fallbacks)
   const envApiKey = getApiToken();
   const envApiUrl = getApiUrl();
+  const envBuildName = getBuildName();
   const envParallelId = getParallelId();
   if (envApiKey) {
     config.apiKey = envApiKey;
     output.debug('config', 'using token from environment');
   }
   if (envApiUrl !== 'https://app.vizzly.dev') config.apiUrl = envApiUrl;
+  if (envBuildName) {
+    config.build.name = envBuildName;
+    output.debug('config', 'using build name from environment');
+  }
   if (envParallelId) config.parallelId = envParallelId;
 
   // 5. Apply CLI overrides (highest priority)

package/dist/utils/environment-config.js

@@ -77,6 +77,14 @@ export function getParallelId() {
   return process.env.VIZZLY_PARALLEL_ID;
 }
 
+/**
+ * Get build name from environment
+ * @returns {string|undefined} Build name
+ */
+export function getBuildName() {
+  return process.env.VIZZLY_BUILD_NAME;
+}
+
 /**
  * Check if TDD mode is enabled
  * @returns {boolean} Whether TDD mode is enabled
@@ -107,6 +115,7 @@ export function getAllEnvironmentConfig() {
     enabled: isVizzlyEnabled(),
     serverUrl: getServerUrl(),
     buildId: getBuildId(),
+    buildName: getBuildName(),
     parallelId: getParallelId(),
     tddMode: isTddMode()
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vizzly-testing/cli",
-  "version": "0.24.1",
+  "version": "0.25.0",
   "description": "Visual review platform for UI developers and designers",
   "keywords": [
     "visual-testing",