Function diffCommand

src/cli/commands/screenshot.ts:40–87

({ positionals, flags, client })

};

export const diffCommand: ClientCommandHandler = async ({ positionals, flags, client }) => {
  if (positionals[0] === 'snapshot') {
    const result = await runCliCommand({ client, command: 'diff', positionals, flags });
    writeCommandOutput(flags, result, () => formatSnapshotDiffText(result));
    return true;
  }

  if (positionals[0] !== 'screenshot') return false;

  const baselineRaw = flags.baseline;
  if (!baselineRaw || typeof baselineRaw !== 'string') {
    throw new AppError('INVALID_ARGS', 'diff screenshot requires --baseline <path>');
  }

  const baselinePath = resolveUserPath(baselineRaw);
  const outputPath = typeof flags.out === 'string' ? resolveUserPath(flags.out) : undefined;
  const currentRaw = positionals[1];
  if (positionals.length > 2) {
    throw new AppError(
      'INVALID_ARGS',
      'diff screenshot accepts at most one current screenshot path',
    );
  }

  const runtime = createAgentDevice({
    backend: createClientScreenshotBackend(client, flags),
    artifacts: createLocalArtifactAdapter(),
    sessions: {
      get: (name) => ({ name }),
      set: () => {},
    },
    policy: localCommandPolicy(),
  });

  const result = await runtime.capture.diffScreenshot({
    session: flags.session,
    baseline: { kind: 'path', path: baselinePath },
    current: currentRaw ? { kind: 'path', path: resolveUserPath(currentRaw) } : { kind: 'live' },
    ...(outputPath ? { out: { kind: 'path', path: outputPath } } : {}),
    threshold: parseCliThreshold(flags.threshold),
    overlayRefs: flags.overlayRefs,
    normalizeStatusBar: flags.screenshotNormalizeStatusBar,
    surface: flags.surface,
  });

  writeCommandOutput(flags, result, () => formatScreenshotDiffText(result));
  return true;
};

function createClientScreenshotBackend(
  client: AgentDeviceClient,