@vizzly-testing/cli 0.35.3-beta.4 → 0.37.0

package/dist/commands/run.js

@@ -1,5 +1,10 @@
 /**
- * Run command implementation
+ * Run tests and report their visual results in terminal or JSON output.
+ *
+ * Incomplete uploads preserve the test exit code and skip comparison waiting.
+ * After successful uploads, --wait can still fail for visual comparison results.
+ * The returned success flag describes command success, not upload completeness.
+ *
  * Uses functional operations directly - no class wrappers needed
  */
 
@@ -16,6 +21,14 @@ import { loadConfig as defaultLoadConfig } from '../utils/config-loader.js';
 import { detectBranch as defaultDetectBranch, detectCommit as defaultDetectCommit, detectCommitMessage as defaultDetectCommitMessage, detectPullRequestNumber as defaultDetectPullRequestNumber, generateBuildNameWithGit as defaultGenerateBuildNameWithGit } from '../utils/git.js';
 import * as defaultOutput from '../utils/output.js';
 import { writeSession as defaultWriteSession } from '../utils/session.js';
+function formatUploadCounts({
+  total,
+  uploaded,
+  reused,
+  failed
+}) {
+  return `${total} captured, ${uploaded} uploaded, ${reused} reused, ${failed} failed`;
+}
 export async function resolveBuildDisplayUrl({
   result,
   config,
@@ -48,19 +61,19 @@ export async function resolveBuildDisplayUrl({
 /**
  * Build the follow-up command for a cloud run.
  *
- * JSON consumers need a self-contained command that returns structured
- * evidence when executed. Human output keeps the existing readable summary.
+ * JSON consumers start with the public schema so they can discover the current
+ * request shape. Human output keeps the readable context summary.
  *
  * @param {string} buildId - Cloud build ID to inspect.
  * @param {Object} options - Command output options.
  * @param {boolean} [options.structured=false] - Include machine-readable JSON.
- * @returns {string} Executable build context command.
+ * @returns {string} Cloud context or schema discovery command.
  */
 function buildContextCommand(buildId, {
   structured = false
 } = {}) {
-  let jsonFlag = structured ? ' --json' : '';
-  return `vizzly context build ${buildId} --agent${jsonFlag} --source cloud`;
+  if (structured) return 'vizzly api schema sdk.getBuildContext --json';
+  return `vizzly context build ${buildId} --source cloud`;
 }
 
 /**
@@ -68,7 +81,9 @@ function buildContextCommand(buildId, {
  * @param {string} testCommand - Test command to execute
  * @param {Object} options - Command options
  * @param {Object} globalOptions - Global CLI options
- * @param {Object} deps - Dependencies for testing
+ * @param {Object} deps - Command services and process hooks.
+ * @returns {Promise<Object>} Command outcome with success, an optional exitCode,
+ * and run results when available.
  */
 export async function runCommand(testCommand, options = {}, globalOptions = {}, deps = {}) {
   let {
@@ -321,6 +336,33 @@ export async function runCommand(testCommand, options = {}, globalOptions = {},
       if (result.buildId) {
         buildId = result.buildId;
       }
+      if (result.uploads?.failed > 0) {
+        let message = `${result.uploads.failed} screenshot(s) failed to upload. Visual testing is incomplete.`;
+        if (globalOptions.json) {
+          output.data({
+            buildId: result.buildId,
+            status: 'incomplete',
+            screenshotsCaptured: result.screenshotsCaptured,
+            uploads: result.uploads,
+            error: {
+              code: 'SCREENSHOT_UPLOAD_FAILED',
+              message
+            },
+            url: result.url,
+            exitCode: 0
+          });
+        } else {
+          output.warn(message);
+          output.print(`Screenshots: ${formatUploadCounts(result.uploads)}`);
+          if (result.url) output.info(`Results: ${result.url}`);
+        }
+        output.cleanup();
+        return {
+          success: true,
+          exitCode: 0,
+          result
+        };
+      }
 
       // JSON output mode - output structured data and exit
       if (globalOptions.json && !runOptions.wait) {
@@ -336,6 +378,9 @@ export async function runCommand(testCommand, options = {}, globalOptions = {},
           status: 'completed',
           url: displayUrl,
           screenshotsCaptured: result.screenshotsCaptured || 0,
+          ...(result.uploads ? {
+            uploads: result.uploads
+          } : {}),
           executionTimeMs,
           git: {
             branch,
@@ -362,7 +407,8 @@ export async function runCommand(testCommand, options = {}, globalOptions = {},
       if (result.buildId && !globalOptions.json) {
         output.blank();
         let colors = output.getColors();
-        output.print(`  ${colors.brand.textTertiary('Screenshots')}  ${colors.white(result.screenshotsCaptured)}`);
+        let screenshotSummary = result.uploads ? formatUploadCounts(result.uploads) : result.screenshotsCaptured;
+        output.print(`  ${colors.brand.textTertiary('Screenshots')}  ${colors.white(screenshotSummary)}`);
         let displayUrl = await resolveBuildDisplayUrl({
           result,
           config,
@@ -392,6 +438,9 @@ export async function runCommand(testCommand, options = {}, globalOptions = {},
           output.data({
             buildId: buildId || null,
             status: 'failed',
+            ...(error.uploads ? {
+              uploads: error.uploads
+            } : {}),
             error: {
               code: error.code,
               message: error.message
@@ -479,6 +528,9 @@ export async function runCommand(testCommand, options = {}, globalOptions = {},
             status: buildResult.status,
             url: displayUrl,
             screenshotsCaptured: result.screenshotsCaptured || 0,
+            ...(result.uploads ? {
+              uploads: result.uploads
+            } : {}),
             executionTimeMs,
             git: {
               branch,

package/dist/commands/status.js

@@ -94,8 +94,8 @@ export function createStatusSuggestedCommands(build = {}) {
     return [];
   }
   return [{
-    label: 'Inspect build context',
-    command: `vizzly --json context build ${build.id} --agent --source cloud`
+    label: 'Discover build context API',
+    command: 'vizzly api schema sdk.getBuildContext --json'
   }, {
     label: 'List comparisons',
     command: `vizzly --json comparisons --build ${build.id}`

package/dist/commands/tdd.js

@@ -31,7 +31,7 @@ function buildLocalContextCommand({
   structured = false
 } = {}) {
   let jsonFlag = structured ? ' --json' : '';
-  return `vizzly context build current --source local --agent${jsonFlag}`;
+  return `vizzly context build current --source local${jsonFlag}`;
 }
 
 /**