git-shots-cli 0.2.0 → 0.3.0

package/dist/index.js

@@ -39,10 +39,11 @@ async function upload(config, options) {
   }
   const branch = options.branch ?? execSync("git rev-parse --abbrev-ref HEAD", { encoding: "utf-8" }).trim();
   const sha = options.sha ?? execSync("git rev-parse HEAD", { encoding: "utf-8" }).trim();
-  console.log(chalk.dim(`Project: ${config.project}`));
-  console.log(chalk.dim(`Branch:  ${branch}`));
-  console.log(chalk.dim(`SHA:     ${sha.slice(0, 7)}`));
-  console.log(chalk.dim(`Dir:     ${dir}`));
+  console.log(chalk.dim(`Project:  ${config.project}`));
+  if (config.platform) console.log(chalk.dim(`Platform: ${config.platform}`));
+  console.log(chalk.dim(`Branch:   ${branch}`));
+  console.log(chalk.dim(`SHA:      ${sha.slice(0, 7)}`));
+  console.log(chalk.dim(`Dir:      ${dir}`));
   console.log();
   const files = await glob("**/*.png", { cwd: dir });
   if (files.length === 0) {
@@ -54,6 +55,7 @@ async function upload(config, options) {
   formData.append("project", config.project);
   formData.append("branch", branch);
   formData.append("gitSha", sha);
+  if (config.platform) formData.append("platform", config.platform);
   for (const file of files) {
     const fullPath = resolve2(dir, file);
     const buffer = readFileSync2(fullPath);
@@ -446,21 +448,23 @@ async function hookUninstall(cwd = process.cwd()) {
 // src/index.ts
 var program = new Command();
 program.name("git-shots").description("CLI for git-shots visual regression platform").version("0.1.0");
-program.command("upload").description("Upload screenshots to git-shots").option("-p, --project <slug>", "Project slug").option("-s, --server <url>", "Server URL").option("-d, --directory <path>", "Screenshots directory").option("-b, --branch <name>", "Git branch (auto-detected)").option("--sha <hash>", "Git SHA (auto-detected)").action(async (options) => {
+program.command("upload").description("Upload screenshots to git-shots").option("-p, --project <slug>", "Project slug").option("-s, --server <url>", "Server URL").option("-d, --directory <path>", "Screenshots directory").option("-b, --branch <name>", "Git branch (auto-detected)").option("--sha <hash>", "Git SHA (auto-detected)").option("--platform <name>", "Platform tag (e.g., android, web)").action(async (options) => {
   const config = loadConfig();
   if (options.project) config.project = options.project;
   if (options.server) config.server = options.server;
   if (options.directory) config.directory = options.directory;
+  if (options.platform) config.platform = options.platform;
   if (!config.project) {
     console.error("Error: project slug required. Use --project or .git-shots.json");
     process.exit(1);
   }
   await upload(config, { branch: options.branch, sha: options.sha });
 });
-program.command("compare").description("Compare screenshots between branches").requiredOption("--head <branch>", "Head branch to compare").option("-p, --project <slug>", "Project slug").option("-s, --server <url>", "Server URL").option("--base <branch>", "Base branch (default: main)").option("-t, --threshold <number>", "Mismatch threshold 0-1", parseFloat).action(async (options) => {
+program.command("compare").description("Compare screenshots between branches").requiredOption("--head <branch>", "Head branch to compare").option("-p, --project <slug>", "Project slug").option("-s, --server <url>", "Server URL").option("--base <branch>", "Base branch (default: main)").option("-t, --threshold <number>", "Mismatch threshold 0-1", parseFloat).option("--platform <name>", "Platform tag (e.g., android, web)").action(async (options) => {
   const config = loadConfig();
   if (options.project) config.project = options.project;
   if (options.server) config.server = options.server;
+  if (options.platform) config.platform = options.platform;
   if (!config.project) {
     console.error("Error: project slug required. Use --project or .git-shots.json");
     process.exit(1);
@@ -487,11 +491,12 @@ program.command("pull-baselines").description("Download baseline screenshots fro
   }
   await pullBaselines(config, { branch: options.branch, output: options.output });
 });
-program.command("review").description("Upload screenshots, create review session, and poll for verdict").option("-p, --project <slug>", "Project slug").option("-s, --server <url>", "Server URL").option("-d, --directory <path>", "Screenshots directory").option("-b, --branch <name>", "Git branch (auto-detected)").option("--sha <hash>", "Git SHA (auto-detected)").option("--open", "Open review URL in browser", true).option("--no-open", "Do not open review URL in browser").option("--poll", "Poll for verdict and exit with code", true).option("--no-poll", "Do not poll for verdict").option("--timeout <seconds>", "Polling timeout in seconds", parseInt, 300).action(async (options) => {
+program.command("review").description("Upload screenshots, create review session, and poll for verdict").option("-p, --project <slug>", "Project slug").option("-s, --server <url>", "Server URL").option("-d, --directory <path>", "Screenshots directory").option("-b, --branch <name>", "Git branch (auto-detected)").option("--sha <hash>", "Git SHA (auto-detected)").option("--platform <name>", "Platform tag (e.g., android, web)").option("--open", "Open review URL in browser", true).option("--no-open", "Do not open review URL in browser").option("--poll", "Poll for verdict and exit with code", true).option("--no-poll", "Do not poll for verdict").option("--timeout <seconds>", "Polling timeout in seconds", parseInt, 300).action(async (options) => {
   const config = loadConfig();
   if (options.project) config.project = options.project;
   if (options.server) config.server = options.server;
   if (options.directory) config.directory = options.directory;
+  if (options.platform) config.platform = options.platform;
   if (!config.project) {
     console.error("Error: project slug required. Use --project or .git-shots.json");
     process.exit(1);

package/package.json

@@ -1,23 +1,26 @@
-{
-	"name": "git-shots-cli",
-	"version": "0.2.0",
-	"description": "CLI for git-shots visual regression platform",
-	"type": "module",
-	"bin": {
-		"git-shots": "./dist/index.js"
-	},
-	"scripts": {
-		"build": "tsup src/index.ts --format esm --dts",
-		"dev": "tsup src/index.ts --format esm --watch"
-	},
-	"dependencies": {
-		"commander": "^12.0.0",
-		"chalk": "^5.3.0",
-		"glob": "^11.0.0"
-	},
-	"devDependencies": {
-		"tsup": "^8.0.0",
-		"typescript": "^5.0.0",
-		"@types/node": "^22.0.0"
-	}
-}
+{
+	"name": "git-shots-cli",
+	"version": "0.3.0",
+	"description": "CLI for git-shots visual regression platform",
+	"type": "module",
+	"bin": {
+		"git-shots": "./dist/index.js"
+	},
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"build": "tsup src/index.ts --format esm --dts",
+		"dev": "tsup src/index.ts --format esm --watch"
+	},
+	"dependencies": {
+		"commander": "^12.0.0",
+		"chalk": "^5.3.0",
+		"glob": "^11.0.0"
+	},
+	"devDependencies": {
+		"tsup": "^8.0.0",
+		"typescript": "^5.0.0",
+		"@types/node": "^22.0.0"
+	}
+}

package/src/compare.ts

@@ -1,57 +0,0 @@
-import chalk from 'chalk';
-import type { GitShotsConfig } from './config.js';
-
-export async function compare(
-	config: GitShotsConfig,
-	options: { base?: string; head: string; threshold?: number }
-) {
-	const url = `${config.server}/api/compare`;
-	const body = {
-		project: config.project,
-		base: options.base ?? 'main',
-		head: options.head,
-		threshold: options.threshold ?? 0.1
-	};
-
-	console.log(chalk.dim(`Comparing ${body.base} vs ${body.head} for ${config.project}...`));
-
-	try {
-		const res = await fetch(url, {
-			method: 'POST',
-			headers: { 'Content-Type': 'application/json', Origin: config.server },
-			body: JSON.stringify(body)
-		});
-		const data = await res.json();
-
-		if (!res.ok) {
-			console.error(chalk.red(`Compare failed: ${JSON.stringify(data)}`));
-			process.exit(1);
-		}
-
-		console.log();
-		console.log(`Compared ${chalk.bold(data.compared)} screens`);
-		console.log();
-
-		if (data.diffs.length === 0) {
-			console.log(chalk.green('No visual differences found!'));
-			return;
-		}
-
-		// Print table
-		console.log(chalk.dim('Screen'.padEnd(30) + 'Mismatch'.padEnd(15) + 'Pixels'));
-		console.log(chalk.dim('-'.repeat(55)));
-
-		for (const d of data.diffs) {
-			const pct = d.mismatchPercentage.toFixed(2) + '%';
-			const color = d.mismatchPercentage > 10 ? chalk.red : d.mismatchPercentage > 1 ? chalk.yellow : chalk.green;
-			console.log(
-				d.screen.padEnd(30) +
-				color(pct.padEnd(15)) +
-				chalk.dim(d.mismatchPixels.toLocaleString())
-			);
-		}
-	} catch (err) {
-		console.error(chalk.red(`Request failed: ${err}`));
-		process.exit(1);
-	}
-}

package/src/config.ts

@@ -1,28 +0,0 @@
-import { readFileSync, existsSync } from 'node:fs';
-import { resolve } from 'node:path';
-
-export interface GitShotsConfig {
-	project: string;
-	server: string;
-	directory: string;
-}
-
-const DEFAULT_CONFIG: GitShotsConfig = {
-	project: '',
-	server: 'https://git-shots.rijid356.workers.dev',
-	directory: 'docs/screenshots/current'
-};
-
-export function loadConfig(cwd: string = process.cwd()): GitShotsConfig {
-	const configPath = resolve(cwd, '.git-shots.json');
-	if (!existsSync(configPath)) {
-		return DEFAULT_CONFIG;
-	}
-	try {
-		const raw = readFileSync(configPath, 'utf-8');
-		const parsed = JSON.parse(raw);
-		return { ...DEFAULT_CONFIG, ...parsed };
-	} catch {
-		return DEFAULT_CONFIG;
-	}
-}

package/src/hook.ts

@@ -1,124 +0,0 @@
-import { existsSync, writeFileSync, unlinkSync, chmodSync, readFileSync } from 'node:fs';
-import { resolve, join } from 'node:path';
-import { execSync } from 'node:child_process';
-import chalk from 'chalk';
-
-const HOOK_MARKER = '# git-shots-hook';
-
-const HOOK_SCRIPT = `#!/bin/sh
-${HOOK_MARKER}
-# Pre-push hook: runs git-shots visual review before pushing.
-# Installed by: git-shots hook install
-
-# Skip if no .git-shots.json config
-if [ ! -f ".git-shots.json" ]; then
-  exit 0
-fi
-
-# Read screenshots directory from config (default: docs/screenshots/current)
-SCREENSHOTS_DIR=$(node -e "try{const c=JSON.parse(require('fs').readFileSync('.git-shots.json','utf-8'));console.log(c.directory||'docs/screenshots/current')}catch{console.log('docs/screenshots/current')}" 2>/dev/null)
-
-# Skip if no screenshots directory or no PNGs
-if [ ! -d "$SCREENSHOTS_DIR" ]; then
-  exit 0
-fi
-
-PNG_COUNT=$(find "$SCREENSHOTS_DIR" -name "*.png" 2>/dev/null | head -1)
-if [ -z "$PNG_COUNT" ]; then
-  exit 0
-fi
-
-# Skip on main/master — no base to diff against
-BRANCH=$(git rev-parse --abbrev-ref HEAD)
-if [ "$BRANCH" = "main" ] || [ "$BRANCH" = "master" ]; then
-  exit 0
-fi
-
-echo ""
-echo "git-shots: Running visual review before push..."
-echo ""
-
-git-shots review
-EXIT_CODE=$?
-
-if [ $EXIT_CODE -eq 1 ]; then
-  echo ""
-  echo "git-shots: Visual review rejected. Push blocked."
-  exit 1
-fi
-
-if [ $EXIT_CODE -eq 2 ]; then
-  echo ""
-  echo "git-shots: Visual review timed out. Push allowed (review pending)."
-  exit 0
-fi
-
-exit 0
-`;
-
-function getGitDir(cwd: string): string {
-	try {
-		return execSync('git rev-parse --git-dir', { cwd, encoding: 'utf-8' }).trim();
-	} catch {
-		throw new Error('Not a git repository');
-	}
-}
-
-export async function hookInstall(cwd: string = process.cwd()) {
-	const gitDir = getGitDir(cwd);
-	const hooksDir = resolve(cwd, gitDir, 'hooks');
-	const hookPath = join(hooksDir, 'pre-push');
-
-	// Check if a pre-push hook already exists
-	if (existsSync(hookPath)) {
-		const existing = readFileSync(hookPath, 'utf-8');
-		if (existing.includes(HOOK_MARKER)) {
-			console.log(chalk.yellow('git-shots pre-push hook is already installed.'));
-			return;
-		}
-
-		// Another hook exists — don't overwrite
-		console.error(
-			chalk.red('A pre-push hook already exists at ') + chalk.dim(hookPath)
-		);
-		console.error(
-			chalk.dim('Remove or rename it first, then re-run this command.')
-		);
-		process.exit(1);
-	}
-
-	writeFileSync(hookPath, HOOK_SCRIPT, { mode: 0o755 });
-
-	// chmod on non-Windows (writeFileSync mode doesn't always stick)
-	try {
-		chmodSync(hookPath, 0o755);
-	} catch {
-		// Windows — mode already set via writeFileSync
-	}
-
-	console.log(chalk.green('Installed pre-push hook at ') + chalk.dim(hookPath));
-	console.log();
-	console.log(chalk.dim('The hook will run `git-shots review` before every push'));
-	console.log(chalk.dim('when .git-shots.json is present and screenshots exist.'));
-}
-
-export async function hookUninstall(cwd: string = process.cwd()) {
-	const gitDir = getGitDir(cwd);
-	const hooksDir = resolve(cwd, gitDir, 'hooks');
-	const hookPath = join(hooksDir, 'pre-push');
-
-	if (!existsSync(hookPath)) {
-		console.log(chalk.yellow('No pre-push hook found.'));
-		return;
-	}
-
-	const existing = readFileSync(hookPath, 'utf-8');
-	if (!existing.includes(HOOK_MARKER)) {
-		console.error(chalk.red('Pre-push hook exists but was not installed by git-shots.'));
-		console.error(chalk.dim('Remove it manually if you want: ') + chalk.dim(hookPath));
-		process.exit(1);
-	}
-
-	unlinkSync(hookPath);
-	console.log(chalk.green('Removed git-shots pre-push hook.'));
-}

package/src/index.ts

@@ -1,140 +0,0 @@
-#!/usr/bin/env node
-import { Command } from 'commander';
-import { loadConfig } from './config.js';
-import { upload } from './upload.js';
-import { compare } from './compare.js';
-import { status } from './status.js';
-import { pullBaselines } from './pull-baselines.js';
-import { review } from './review.js';
-import { hookInstall, hookUninstall } from './hook.js';
-
-const program = new Command();
-
-program
-	.name('git-shots')
-	.description('CLI for git-shots visual regression platform')
-	.version('0.1.0');
-
-program
-	.command('upload')
-	.description('Upload screenshots to git-shots')
-	.option('-p, --project <slug>', 'Project slug')
-	.option('-s, --server <url>', 'Server URL')
-	.option('-d, --directory <path>', 'Screenshots directory')
-	.option('-b, --branch <name>', 'Git branch (auto-detected)')
-	.option('--sha <hash>', 'Git SHA (auto-detected)')
-	.action(async (options) => {
-		const config = loadConfig();
-		if (options.project) config.project = options.project;
-		if (options.server) config.server = options.server;
-		if (options.directory) config.directory = options.directory;
-		if (!config.project) {
-			console.error('Error: project slug required. Use --project or .git-shots.json');
-			process.exit(1);
-		}
-		await upload(config, { branch: options.branch, sha: options.sha });
-	});
-
-program
-	.command('compare')
-	.description('Compare screenshots between branches')
-	.requiredOption('--head <branch>', 'Head branch to compare')
-	.option('-p, --project <slug>', 'Project slug')
-	.option('-s, --server <url>', 'Server URL')
-	.option('--base <branch>', 'Base branch (default: main)')
-	.option('-t, --threshold <number>', 'Mismatch threshold 0-1', parseFloat)
-	.action(async (options) => {
-		const config = loadConfig();
-		if (options.project) config.project = options.project;
-		if (options.server) config.server = options.server;
-		if (!config.project) {
-			console.error('Error: project slug required. Use --project or .git-shots.json');
-			process.exit(1);
-		}
-		await compare(config, { base: options.base, head: options.head, threshold: options.threshold });
-	});
-
-program
-	.command('status')
-	.description('Show current diff status')
-	.option('-p, --project <slug>', 'Project slug')
-	.option('-s, --server <url>', 'Server URL')
-	.action(async (options) => {
-		const config = loadConfig();
-		if (options.project) config.project = options.project;
-		if (options.server) config.server = options.server;
-		if (!config.project) {
-			console.error('Error: project slug required. Use --project or .git-shots.json');
-			process.exit(1);
-		}
-		await status(config);
-	});
-
-program
-	.command('pull-baselines')
-	.description('Download baseline screenshots from git-shots')
-	.option('-p, --project <slug>', 'Project slug')
-	.option('-s, --server <url>', 'Server URL')
-	.option('-o, --output <path>', 'Output directory')
-	.option('-b, --branch <name>', 'Branch to pull baselines from (default: main)')
-	.action(async (options) => {
-		const config = loadConfig();
-		if (options.project) config.project = options.project;
-		if (options.server) config.server = options.server;
-		if (!config.project) {
-			console.error('Error: project slug required. Use --project or .git-shots.json');
-			process.exit(1);
-		}
-		await pullBaselines(config, { branch: options.branch, output: options.output });
-	});
-
-program
-	.command('review')
-	.description('Upload screenshots, create review session, and poll for verdict')
-	.option('-p, --project <slug>', 'Project slug')
-	.option('-s, --server <url>', 'Server URL')
-	.option('-d, --directory <path>', 'Screenshots directory')
-	.option('-b, --branch <name>', 'Git branch (auto-detected)')
-	.option('--sha <hash>', 'Git SHA (auto-detected)')
-	.option('--open', 'Open review URL in browser', true)
-	.option('--no-open', 'Do not open review URL in browser')
-	.option('--poll', 'Poll for verdict and exit with code', true)
-	.option('--no-poll', 'Do not poll for verdict')
-	.option('--timeout <seconds>', 'Polling timeout in seconds', parseInt, 300)
-	.action(async (options) => {
-		const config = loadConfig();
-		if (options.project) config.project = options.project;
-		if (options.server) config.server = options.server;
-		if (options.directory) config.directory = options.directory;
-		if (!config.project) {
-			console.error('Error: project slug required. Use --project or .git-shots.json');
-			process.exit(1);
-		}
-		await review(config, {
-			branch: options.branch,
-			sha: options.sha,
-			open: options.open,
-			poll: options.poll,
-			timeout: options.timeout
-		});
-	});
-
-const hook = program
-	.command('hook')
-	.description('Manage git hooks for automatic visual review');
-
-hook
-	.command('install')
-	.description('Install a pre-push hook that runs git-shots review before each push')
-	.action(async () => {
-		await hookInstall();
-	});
-
-hook
-	.command('uninstall')
-	.description('Remove the git-shots pre-push hook')
-	.action(async () => {
-		await hookUninstall();
-	});
-
-program.parse();

package/src/pull-baselines.ts

@@ -1,87 +0,0 @@
-import { mkdirSync, writeFileSync } from 'node:fs';
-import { resolve, dirname } from 'node:path';
-import chalk from 'chalk';
-import type { GitShotsConfig } from './config.js';
-
-interface Snapshot {
-	screen_slug: string;
-	category: string | null;
-	r2_key: string;
-	git_sha: string;
-	width: number;
-	height: number;
-}
-
-export async function pullBaselines(
-	config: GitShotsConfig,
-	options: { branch?: string; output?: string }
-) {
-	const branch = options.branch ?? 'main';
-	const outputDir = resolve(process.cwd(), options.output ?? config.directory);
-
-	console.log(chalk.dim(`Project: ${config.project}`));
-	console.log(chalk.dim(`Branch:  ${branch}`));
-	console.log(chalk.dim(`Output:  ${outputDir}`));
-	console.log();
-
-	// Fetch manifest
-	const manifestUrl = `${config.server}/api/projects/${encodeURIComponent(config.project)}/snapshots?branch=${encodeURIComponent(branch)}`;
-	let snapshots: Snapshot[];
-
-	try {
-		const res = await fetch(manifestUrl);
-		const data = await res.json();
-
-		if (!res.ok) {
-			console.error(chalk.red(`Failed to fetch snapshots: ${JSON.stringify(data)}`));
-			process.exit(1);
-		}
-
-		snapshots = data.snapshots;
-	} catch (err) {
-		console.error(chalk.red(`Request failed: ${err}`));
-		process.exit(1);
-	}
-
-	if (snapshots.length === 0) {
-		console.log(chalk.yellow('No baseline snapshots found.'));
-		return;
-	}
-
-	console.log(chalk.dim(`Found ${snapshots.length} baselines to download`));
-	console.log();
-
-	// Download in batches of 5
-	const batchSize = 5;
-	let downloaded = 0;
-
-	for (let i = 0; i < snapshots.length; i += batchSize) {
-		const batch = snapshots.slice(i, i + batchSize);
-		await Promise.all(
-			batch.map(async (snap) => {
-				const imageUrl = `${config.server}/api/images/${snap.r2_key}`;
-				const res = await fetch(imageUrl);
-				if (!res.ok) {
-					console.error(chalk.red(`  Failed to download ${snap.screen_slug}: ${res.status}`));
-					return;
-				}
-
-				const buffer = Buffer.from(await res.arrayBuffer());
-				const subDir = snap.category ?? '';
-				const filePath = resolve(outputDir, subDir, `${snap.screen_slug}.png`);
-
-				mkdirSync(dirname(filePath), { recursive: true });
-				writeFileSync(filePath, buffer);
-
-				downloaded++;
-				console.log(
-					chalk.green(`  [${downloaded}/${snapshots.length}]`) +
-						` ${subDir ? subDir + '/' : ''}${snap.screen_slug}.png`
-				);
-			})
-		);
-	}
-
-	console.log();
-	console.log(chalk.green(`Downloaded ${downloaded} baselines to ${outputDir}`));
-}

package/src/review.ts

@@ -1,199 +0,0 @@
-import { execSync } from 'node:child_process';
-import { platform } from 'node:os';
-import chalk from 'chalk';
-import type { GitShotsConfig } from './config.js';
-import { upload } from './upload.js';
-
-interface ReviewOptions {
-	branch?: string;
-	sha?: string;
-	open?: boolean;
-	poll?: boolean;
-	timeout?: number;
-}
-
-interface ReviewResponse {
-	review: {
-		id: number;
-		status: string;
-		url: string;
-	};
-	diffs: Array<{
-		screen: string;
-		mismatchPercentage: number;
-		mismatchPixels: number;
-	}>;
-}
-
-interface ReviewStatusResponse {
-	review: {
-		id: number;
-		status: string;
-	};
-	diffs: Array<{
-		base: { screen_slug: string };
-		mismatch_percentage: number;
-		status: string;
-	}>;
-}
-
-function openBrowser(url: string): void {
-	try {
-		const os = platform();
-		if (os === 'win32') {
-			execSync(`start "" "${url}"`, { stdio: 'ignore' });
-		} else if (os === 'darwin') {
-			execSync(`open "${url}"`, { stdio: 'ignore' });
-		} else {
-			execSync(`xdg-open "${url}"`, { stdio: 'ignore' });
-		}
-	} catch {
-		console.log(chalk.dim(`Could not open browser. Visit the URL manually.`));
-	}
-}
-
-function sleep(ms: number): Promise<void> {
-	return new Promise((resolve) => setTimeout(resolve, ms));
-}
-
-export async function review(config: GitShotsConfig, options: ReviewOptions) {
-	const shouldOpen = options.open ?? true;
-	const shouldPoll = options.poll ?? true;
-	const timeoutSec = options.timeout ?? 300;
-
-	// Get git info
-	const branch =
-		options.branch ??
-		execSync('git rev-parse --abbrev-ref HEAD', { encoding: 'utf-8' }).trim();
-	const sha =
-		options.sha ?? execSync('git rev-parse HEAD', { encoding: 'utf-8' }).trim();
-
-	console.log(chalk.dim(`Project: ${config.project}`));
-	console.log(chalk.dim(`Branch:  ${branch}`));
-	console.log(chalk.dim(`SHA:     ${sha.slice(0, 7)}`));
-	console.log();
-
-	// Step 1: Upload screenshots
-	console.log(chalk.dim('Uploading screenshots...'));
-	await upload(config, { branch, sha });
-	console.log();
-
-	// Step 2: Create review session via POST /api/reviews
-	console.log(chalk.dim('Creating review session...'));
-
-	const reviewUrl = `${config.server}/api/reviews`;
-	let reviewData: ReviewResponse;
-
-	try {
-		const res = await fetch(reviewUrl, {
-			method: 'POST',
-			headers: { 'Content-Type': 'application/json', Origin: config.server },
-			body: JSON.stringify({
-				project: config.project,
-				branch,
-				gitSha: sha
-			})
-		});
-		const data = await res.json();
-
-		if (!res.ok) {
-			console.error(chalk.red(`Failed to create review: ${JSON.stringify(data)}`));
-			process.exit(1);
-		}
-
-		reviewData = data as ReviewResponse;
-	} catch (err) {
-		console.error(chalk.red(`Request failed: ${err}`));
-		process.exit(1);
-	}
-
-	// Step 3: Check if all diffs are 0% mismatch
-	const allZero =
-		reviewData.diffs.length === 0 ||
-		reviewData.diffs.every((d) => d.mismatchPercentage === 0);
-
-	if (allZero) {
-		console.log(chalk.green('No visual changes detected.'));
-		process.exit(0);
-	}
-
-	// Step 4: Print review URL and diff summary
-	const sessionUrl = `${config.server}/reviews/${reviewData.review.id}`;
-	console.log();
-	console.log(chalk.bold('Visual changes detected:'));
-	console.log();
-
-	for (const d of reviewData.diffs) {
-		const pct = d.mismatchPercentage.toFixed(2) + '%';
-		const color =
-			d.mismatchPercentage > 10
-				? chalk.red
-				: d.mismatchPercentage > 1
-					? chalk.yellow
-					: chalk.green;
-		console.log(`  ${d.screen.padEnd(30)} ${color(pct)}`);
-	}
-
-	console.log();
-	console.log(`Review: ${chalk.cyan(sessionUrl)}`);
-
-	// Step 5: Open in browser
-	if (shouldOpen) {
-		openBrowser(sessionUrl);
-	}
-
-	// Step 6: Poll for verdict
-	if (!shouldPoll) {
-		return;
-	}
-
-	console.log();
-	console.log(chalk.dim(`Polling for verdict (timeout: ${timeoutSec}s)...`));
-
-	const pollInterval = 3000;
-	const startTime = Date.now();
-	const deadline = startTime + timeoutSec * 1000;
-
-	while (Date.now() < deadline) {
-		await sleep(pollInterval);
-
-		try {
-			const res = await fetch(`${config.server}/api/reviews/${reviewData.review.id}`, {
-				headers: { Origin: config.server }
-			});
-			const data = (await res.json()) as ReviewStatusResponse;
-
-			if (!res.ok) continue;
-
-			if (data.review.status === 'approved') {
-				console.log();
-				console.log(chalk.green.bold('Review approved!'));
-				process.exit(0);
-			}
-
-			if (data.review.status === 'rejected') {
-				console.log();
-				console.log(chalk.red.bold('Review rejected.'));
-
-				// Show which screens had issues
-				const rejected = data.diffs.filter((d) => d.status === 'rejected');
-				if (rejected.length > 0) {
-					console.log(chalk.dim('Rejected screens:'));
-					for (const d of rejected) {
-						console.log(chalk.red(`  - ${d.base.screen_slug}`));
-					}
-				}
-
-				process.exit(1);
-			}
-		} catch {
-			// Network error — keep polling
-		}
-	}
-
-	// Timeout
-	console.log();
-	console.log(chalk.yellow(`Review timed out after ${timeoutSec}s.`));
-	console.log(chalk.dim(`Visit ${sessionUrl} to complete the review.`));
-	process.exit(2);
-}

package/src/status.ts

@@ -1,42 +0,0 @@
-import chalk from 'chalk';
-import type { GitShotsConfig } from './config.js';
-
-export async function status(config: GitShotsConfig) {
-	const url = `${config.server}/api/diffs?project=${encodeURIComponent(config.project)}`;
-
-	try {
-		const res = await fetch(url);
-		const data = await res.json();
-
-		if (!res.ok) {
-			console.error(chalk.red(`Status failed: ${JSON.stringify(data)}`));
-			process.exit(1);
-		}
-
-		if (data.length === 0) {
-			console.log(chalk.dim('No diffs found for this project.'));
-			return;
-		}
-
-		console.log(`${chalk.bold(data.length)} diffs for ${config.project}`);
-		console.log();
-		console.log(chalk.dim('ID'.padEnd(8) + 'Status'.padEnd(12) + 'Mismatch'.padEnd(12) + 'Date'));
-		console.log(chalk.dim('-'.repeat(50)));
-
-		for (const { diff } of data) {
-			const statusColor =
-				diff.status === 'approved' ? chalk.green :
-				diff.status === 'rejected' ? chalk.red :
-				chalk.yellow;
-			console.log(
-				String(diff.id).padEnd(8) +
-				statusColor(diff.status.padEnd(12)) +
-				(diff.mismatch_percentage.toFixed(2) + '%').padEnd(12) +
-				chalk.dim(new Date(diff.created_at * 1000).toLocaleDateString())
-			);
-		}
-	} catch (err) {
-		console.error(chalk.red(`Request failed: ${err}`));
-		process.exit(1);
-	}
-}

package/src/upload.ts

@@ -1,74 +0,0 @@
-import { readFileSync, existsSync } from 'node:fs';
-import { resolve, basename, relative, dirname } from 'node:path';
-import { execSync } from 'node:child_process';
-import { glob } from 'glob';
-import chalk from 'chalk';
-import type { GitShotsConfig } from './config.js';
-
-export async function upload(config: GitShotsConfig, options: { branch?: string; sha?: string }) {
-	const dir = resolve(process.cwd(), config.directory);
-	if (!existsSync(dir)) {
-		console.error(chalk.red(`Directory not found: ${dir}`));
-		process.exit(1);
-	}
-
-	// Get git info
-	const branch = options.branch ?? execSync('git rev-parse --abbrev-ref HEAD', { encoding: 'utf-8' }).trim();
-	const sha = options.sha ?? execSync('git rev-parse HEAD', { encoding: 'utf-8' }).trim();
-
-	console.log(chalk.dim(`Project: ${config.project}`));
-	console.log(chalk.dim(`Branch:  ${branch}`));
-	console.log(chalk.dim(`SHA:     ${sha.slice(0, 7)}`));
-	console.log(chalk.dim(`Dir:     ${dir}`));
-	console.log();
-
-	// Find all PNGs
-	const files = await glob('**/*.png', { cwd: dir });
-	if (files.length === 0) {
-		console.log(chalk.yellow('No PNG files found.'));
-		return;
-	}
-
-	console.log(chalk.dim(`Found ${files.length} screenshots`));
-
-	// Build multipart form
-	const formData = new FormData();
-	formData.append('project', config.project);
-	formData.append('branch', branch);
-	formData.append('gitSha', sha);
-
-	for (const file of files) {
-		const fullPath = resolve(dir, file);
-		const buffer = readFileSync(fullPath);
-		const blob = new Blob([buffer], { type: 'image/png' });
-
-		// Use directory as field name for category derivation
-		const dirName = dirname(file);
-		const fieldName = dirName !== '.' ? `${dirName}/${basename(file)}` : basename(file);
-
-		formData.append(fieldName, blob, basename(file));
-	}
-
-	// Upload
-	const url = `${config.server}/api/upload`;
-	console.log(chalk.dim(`Uploading to ${url}...`));
-
-	try {
-		const res = await fetch(url, {
-			method: 'POST',
-			body: formData,
-			headers: { Origin: config.server },
-		});
-		const data = await res.json();
-
-		if (!res.ok) {
-			console.error(chalk.red(`Upload failed: ${JSON.stringify(data)}`));
-			process.exit(1);
-		}
-
-		console.log(chalk.green(`Uploaded ${data.uploaded} screenshots`));
-	} catch (err) {
-		console.error(chalk.red(`Request failed: ${err}`));
-		process.exit(1);
-	}
-}

package/tsconfig.json

@@ -1,14 +0,0 @@
-{
-	"compilerOptions": {
-		"target": "ES2022",
-		"module": "ESNext",
-		"moduleResolution": "bundler",
-		"esModuleInterop": true,
-		"strict": true,
-		"outDir": "dist",
-		"rootDir": "src",
-		"declaration": true,
-		"skipLibCheck": true
-	},
-	"include": ["src"]
-}