@vizzly-testing/cli 0.35.2 → 0.35.3-beta.1

package/dist/context/local-workspace-provider.js

@@ -1,3 +1,4 @@
+import { createHash } from 'node:crypto';
 import { existsSync as defaultExistsSync, readFileSync } from 'node:fs';
 import { basename, isAbsolute, join } from 'node:path';
 import { pathToFileURL } from 'node:url';
@@ -140,17 +141,28 @@ function buildComparisonLinks(snapshot, comparisonId) {
     comparison_url: `http://127.0.0.1:${snapshot.serverInfo.port}/comparison/${encodeURIComponent(comparisonId)}`
   };
 }
+
+/**
+ * Describe the local evidence set without borrowing cloud run identity.
+ *
+ * A cloud `session.json` can coexist with older file-backed TDD evidence. Using
+ * that session here makes stale local comparisons look like the current cloud
+ * build, so local identity comes only from the active local server.
+ *
+ * @param {Object} snapshot - Persisted local workspace evidence.
+ * @returns {Object} Build-shaped identity for the local context payload.
+ */
 function buildBuildSnapshot(snapshot) {
-  let buildId = snapshot.session?.buildId || snapshot.serverInfo?.buildId || 'local-workspace';
+  let buildId = snapshot.serverInfo?.buildId || 'local-workspace';
   return {
     id: buildId,
     name: buildId,
-    branch: snapshot.session?.branch || 'local',
-    commit_sha: snapshot.session?.commit || null,
+    branch: 'local',
+    commit_sha: null,
     commit_message: null,
     approval_status: snapshot.serverInfo ? 'pending' : 'approved',
     status: snapshot.serverInfo ? 'running' : 'completed',
-    created_at: snapshot.session?.createdAt || null
+    created_at: null
   };
 }
 function buildBaselineSnapshot(snapshot) {
@@ -193,31 +205,6 @@ function buildReviewState(build, reviewSummary) {
     unresolved_comments: 0
   };
 }
-function mapLocalScreenshot(snapshot, comparison) {
-  let mapped = mapLocalComparison(snapshot, comparison);
-  let baselineBuildId = snapshot.baselineMetadata?.buildId || null;
-  return {
-    id: mapped.screenshot.id,
-    name: mapped.screenshot.name,
-    browser: mapped.screenshot.browser,
-    viewport: {
-      width: mapped.screenshot.viewport_width,
-      height: mapped.screenshot.viewport_height
-    },
-    url: mapped.screenshot.original_url,
-    baseline: mapped.baseline ? {
-      id: mapped.baseline.id,
-      build_id: baselineBuildId,
-      name: mapped.baseline.name,
-      browser: mapped.baseline.browser,
-      viewport: {
-        width: mapped.baseline.viewport_width,
-        height: mapped.baseline.viewport_height
-      },
-      url: mapped.baseline.original_url
-    } : null
-  };
-}
 function mapLocalComparison(snapshot, comparison) {
   let details = snapshot.comparisonDetails[comparison.id] || {};
   let comparisonName = comparison.originalName || comparison.name;
@@ -295,6 +282,141 @@ function mapLocalComparison(snapshot, comparison) {
     }
   };
 }
+function projectLocalScreenshot(screenshot, baseline) {
+  if (!screenshot) return null;
+  return {
+    id: screenshot.id,
+    name: screenshot.name,
+    browser: screenshot.browser,
+    viewport: {
+      width: screenshot.viewport_width,
+      height: screenshot.viewport_height
+    },
+    url: screenshot.original_url,
+    baseline: baseline ? {
+      id: baseline.id,
+      build_id: baseline.build_id,
+      name: baseline.name,
+      browser: baseline.browser,
+      viewport: {
+        width: baseline.viewport_width,
+        height: baseline.viewport_height
+      },
+      url: baseline.original_url
+    } : null
+  };
+}
+function projectLocalDiff(diff, includeDiffs) {
+  let projected = {
+    percentage: diff?.percentage ?? null,
+    changed_pixels: diff?.changed_pixels ?? null,
+    total_pixels: diff?.total_pixels ?? null,
+    threshold: diff?.threshold ?? null,
+    image_url: diff?.image_url ?? null,
+    fingerprint_hash: diff?.fingerprint_hash ?? null,
+    region_count: Array.isArray(diff?.regions) ? diff.regions.length : null
+  };
+  if (includeDiffs) {
+    projected.regions = diff?.regions || [];
+    projected.cluster_metadata = diff?.cluster_metadata ?? null;
+    projected.fingerprint_data = diff?.fingerprint_data ?? null;
+    projected.diff_lines = diff?.diff_lines ?? [];
+  }
+  return projected;
+}
+function projectLocalEvidence(comparison, includeDiffs) {
+  return {
+    type: 'comparison',
+    id: comparison.id,
+    screenshot_name: comparison.screenshot_name,
+    status: comparison.status,
+    result: comparison.result,
+    approval_status: comparison.approval_status,
+    needs_review: comparison.needs_review,
+    build_id: comparison.build_id,
+    build_name: comparison.build_name,
+    build_branch: comparison.build_branch,
+    build_commit_sha: comparison.build_commit_sha,
+    build_created_at: comparison.build_created_at,
+    screenshot: projectLocalScreenshot(comparison.screenshot, comparison.baseline),
+    diff: projectLocalDiff(comparison.diff, includeDiffs)
+  };
+}
+function projectLocalFocusedComparison(comparison, includeDiffs) {
+  if (includeDiffs) return comparison;
+  let analysis = comparison.analysis || {};
+  let {
+    diff_regions: _diffRegions,
+    cluster_metadata: _clusterMetadata,
+    fingerprint_data: _fingerprintData,
+    diff_lines: _diffLines,
+    ...summaryAnalysis
+  } = analysis;
+  return {
+    ...comparison,
+    diff: projectLocalDiff(comparison.diff, false),
+    analysis: summaryAnalysis
+  };
+}
+function projectLocalHistoryItem(comparison) {
+  return {
+    id: comparison.id,
+    screenshot_name: comparison.screenshot_name,
+    result: comparison.result,
+    status: comparison.status,
+    needs_review: comparison.needs_review,
+    build_id: comparison.build_id,
+    build_name: comparison.build_name,
+    build_branch: comparison.build_branch,
+    build_created_at: comparison.build_created_at,
+    screenshot: projectLocalScreenshot(comparison.screenshot, comparison.baseline),
+    diff: {
+      percentage: comparison.diff?.percentage ?? null,
+      fingerprint_hash: comparison.diff?.fingerprint_hash ?? null,
+      region_count: Array.isArray(comparison.diff?.regions) ? comparison.diff.regions.length : null
+    }
+  };
+}
+function compactLocalCollection(items) {
+  return {
+    total: Array.isArray(items) ? items.length : null,
+    included: false,
+    details_available: Array.isArray(items) && items.length > 0
+  };
+}
+function createLocalDynamicRegions(comparison = null) {
+  let confirmedRegions = comparison?.analysis?.confirmed_regions;
+  let hotspotAnalysis = comparison?.analysis?.hotspot_analysis;
+  return {
+    decision: null,
+    patterns: compactLocalCollection([]),
+    confirmed_regions: compactLocalCollection(confirmedRegions),
+    exclusions: {
+      total: null,
+      included: false,
+      details_available: false
+    },
+    hotspot_analysis: hotspotAnalysis ? {
+      total_builds_analyzed: hotspotAnalysis.total_builds_analyzed ?? null,
+      confidence: hotspotAnalysis.confidence ?? null,
+      confidence_score: hotspotAnalysis.confidence_score ?? null,
+      data_source: hotspotAnalysis.data_source ?? null,
+      coverage: hotspotAnalysis.coverage ?? null,
+      confirmed_region_coverage: hotspotAnalysis.confirmed_region_coverage ?? null
+    } : null
+  };
+}
+function createLocalSnapshotRevision(snapshot) {
+  let revisionInput = {
+    serverInfo: snapshot.serverInfo,
+    reportData: snapshot.reportData,
+    comparisonDetails: snapshot.comparisonDetails,
+    baselineMetadata: snapshot.baselineMetadata,
+    hotspotFile: snapshot.hotspotFile,
+    regionFile: snapshot.regionFile
+  };
+  return createHash('sha256').update(JSON.stringify(revisionInput)).digest('base64url');
+}
 function buildReviewSummary(comparisons = []) {
   let approved = comparisons.filter(comparison => mapApprovalStatus(comparison.status) === 'approved').length;
   let rejected = comparisons.filter(comparison => mapApprovalStatus(comparison.status) === 'rejected').length;
@@ -333,7 +455,6 @@ export function createLocalWorkspaceContextProvider(options = {}, deps = {}) {
       vizzlyDir,
       existsSync,
       serverInfo: readJson(join(vizzlyDir, 'server.json')),
-      session: readJson(join(vizzlyDir, 'session.json')),
       reportData: normalizeReportData(readJson(join(vizzlyDir, 'report-data.json')) || createEmptyReportData()),
       comparisonDetails: readJson(join(vizzlyDir, 'comparison-details.json')) || {},
       baselineMetadata: readJson(join(vizzlyDir, 'baselines', 'metadata.json')),
@@ -345,7 +466,7 @@ export function createLocalWorkspaceContextProvider(options = {}, deps = {}) {
     return snapshotCache;
   }
   function isAvailable(snapshot = loadSnapshot()) {
-    return Boolean(snapshot.serverInfo || snapshot.session || snapshot.reportData.comparisons.length > 0 || snapshot.baselineMetadata);
+    return Boolean(snapshot.serverInfo || snapshot.reportData.comparisons.length > 0 || snapshot.baselineMetadata);
   }
   function findComparison(snapshot, target) {
     if (!target) {
@@ -395,17 +516,66 @@ export function createLocalWorkspaceContextProvider(options = {}, deps = {}) {
       } : {})
     };
   }
-  function getBuildContext(buildId) {
+  function createLocalCursor(resource, target, query, stream, offset, revision) {
+    return Buffer.from(JSON.stringify({
+      version: 1,
+      resource,
+      target,
+      query,
+      stream,
+      offset,
+      revision
+    })).toString('base64url');
+  }
+  function readLocalCursor(cursor, resource, target, query, revision, streams) {
+    if (!cursor) return null;
+    try {
+      let parsed = JSON.parse(Buffer.from(cursor, 'base64url').toString());
+      if (parsed.version !== 1 || parsed.resource !== resource || parsed.target !== target || parsed.query !== query || parsed.revision !== revision || !streams.includes(parsed.stream) || !Number.isInteger(parsed.offset) || parsed.offset < 0) {
+        throw new Error('mismatch');
+      }
+      return parsed;
+    } catch {
+      throw createLocalWorkspaceError('The local context cursor is invalid or the local results changed. Start again without --cursor.');
+    }
+  }
+  function createLocalPage(items, {
+    limit,
+    offset,
+    resource,
+    target,
+    query,
+    stream,
+    revision
+  }) {
+    if (offset > items.length) {
+      throw createLocalWorkspaceError('The local context cursor is invalid or the local results changed. Start again without --cursor.');
+    }
+    let pageItems = items.slice(offset, offset + limit);
+    let nextOffset = offset + pageItems.length;
+    let hasMore = nextOffset < items.length;
+    return {
+      items: pageItems,
+      page: {
+        limit,
+        returned: pageItems.length,
+        total: items.length,
+        has_more: hasMore,
+        next_cursor: hasMore ? createLocalCursor(resource, target, query, stream, nextOffset, revision) : null
+      }
+    };
+  }
+  function getBuildContext(buildId, query = {}) {
     let snapshot = loadSnapshot();
     let resolvedBuild = buildBuildSnapshot(snapshot);
     if (!(buildId === 'current' || buildId === 'local' || buildId === resolvedBuild.id)) {
-      throw createLocalWorkspaceError(`Local workspace context is only available for the active session build (${resolvedBuild.id})`);
+      throw createLocalWorkspaceError(`Local workspace context is only available for the active local build (${resolvedBuild.id})`);
     }
     let mappedComparisons = snapshot.reportData.comparisons.map(comparison => mapLocalComparison(snapshot, comparison));
-    let mappedScreenshots = snapshot.reportData.comparisons.map(comparison => mapLocalScreenshot(snapshot, comparison));
+    let mappedScreenshots = mappedComparisons.map(comparison => projectLocalScreenshot(comparison.screenshot, comparison.baseline));
     let reviewSummary = buildReviewSummary(snapshot.reportData.comparisons);
     let reviewState = buildReviewState(resolvedBuild, reviewSummary);
-    return {
+    let context = {
       resource: 'build_context',
       source: LOCAL_CONTEXT_SOURCE,
       scope: createScope(),
@@ -436,8 +606,48 @@ export function createLocalWorkspaceContextProvider(options = {}, deps = {}) {
       },
       links: createBuildLinks(snapshot)
     };
+    if (!query.details) return context;
+    let revision = createLocalSnapshotRevision(snapshot);
+    let limit = query.limit || 10;
+    let cursorQuery = `${query.details}:${limit}`;
+    let cursor = readLocalCursor(query.cursor, 'build_context', resolvedBuild.id, cursorQuery, revision, ['evidence']);
+    let includeDiffs = query.details === 'diffs';
+    let evidence = mappedComparisons.map(comparison => projectLocalEvidence(comparison, includeDiffs));
+    return {
+      resource: 'build_context',
+      source: LOCAL_CONTEXT_SOURCE,
+      scope: context.scope,
+      build: context.build,
+      baseline: context.baseline,
+      status: context.status,
+      summary: context.summary,
+      preview: null,
+      signature_properties: [],
+      dynamic_regions: {
+        exclusions: {
+          total: null,
+          included: false,
+          details_available: false
+        },
+        item_details_included: false
+      },
+      evidence: createLocalPage(evidence, {
+        limit,
+        offset: cursor?.offset || 0,
+        resource: 'build_context',
+        target: resolvedBuild.id,
+        query: cursorQuery,
+        stream: 'evidence',
+        revision
+      }),
+      comments: {
+        build: compactLocalCollection(context.comments.build),
+        screenshot_count: context.comments.screenshot_count
+      },
+      links: context.links
+    };
   }
-  function getComparisonContext(comparisonId) {
+  function getComparisonContext(comparisonId, query = {}) {
     let snapshot = loadSnapshot();
     let comparison = findComparison(snapshot, comparisonId);
     if (!comparison) {
@@ -446,7 +656,7 @@ export function createLocalWorkspaceContextProvider(options = {}, deps = {}) {
     let mappedComparison = mapLocalComparison(snapshot, comparison);
     let comparisonName = comparison.originalName || comparison.name;
     let history = snapshot.reportData.comparisons.filter(candidate => candidate.id !== comparison.id && (candidate.originalName || candidate.name) === comparisonName).map(candidate => mapLocalComparison(snapshot, candidate));
-    return {
+    let context = {
       resource: 'comparison_context',
       source: LOCAL_CONTEXT_SOURCE,
       scope: createScope(),
@@ -475,6 +685,52 @@ export function createLocalWorkspaceContextProvider(options = {}, deps = {}) {
       },
       links: buildComparisonLinks(snapshot, comparison.id)
     };
+    if (!query.details) return context;
+    let revision = createLocalSnapshotRevision(snapshot);
+    let limit = query.limit || 10;
+    let cursorQuery = `${query.details}:${limit}`;
+    let cursor = readLocalCursor(query.cursor, 'comparison_context', comparison.id, cursorQuery, revision, ['similar_by_fingerprint', 'recent_by_name']);
+    let activeStream = cursor?.stream;
+    let similarOffset = activeStream === 'similar_by_fingerprint' ? cursor.offset : 0;
+    let recentOffset = activeStream === 'recent_by_name' ? cursor.offset : 0;
+    return {
+      resource: 'comparison_context',
+      source: LOCAL_CONTEXT_SOURCE,
+      scope: context.scope,
+      build: context.build,
+      signature_properties: [],
+      comparison: projectLocalFocusedComparison(context.comparison, query.details === 'diffs'),
+      dynamic_regions: createLocalDynamicRegions(context.comparison),
+      history: {
+        active_stream: activeStream || null,
+        similar_by_fingerprint: createLocalPage([], {
+          limit,
+          offset: similarOffset,
+          resource: 'comparison_context',
+          target: comparison.id,
+          query: cursorQuery,
+          stream: 'similar_by_fingerprint',
+          revision
+        }),
+        recent_by_name: createLocalPage(history.map(projectLocalHistoryItem), {
+          limit,
+          offset: recentOffset,
+          resource: 'comparison_context',
+          target: comparison.id,
+          query: cursorQuery,
+          stream: 'recent_by_name',
+          revision
+        })
+      },
+      review: {
+        review_summary: context.review.review_summary,
+        assignments: compactLocalCollection(context.review.assignments),
+        build_comments: compactLocalCollection(context.review.build_comments),
+        screenshot_comments: compactLocalCollection(context.review.screenshot_comments)
+      },
+      links: context.links,
+      details: query.details
+    };
   }
   function getScreenshotContext(screenshotName) {
     let snapshot = loadSnapshot();

package/dist/plugin-loader.js

@@ -55,7 +55,7 @@ export async function loadPlugins(configPath, config) {
  * Discover installed plugins from node_modules/@vizzly-testing/*
  * @returns {Promise<Array>} Array of plugin info objects
  */
-export async function discoverInstalledPlugins() {
+async function discoverInstalledPlugins() {
   let plugins = [];
   try {
     // Find all @vizzly-testing packages