svn-visualizer 0.1.0 → 0.1.1

package/oxc.config.ts

@@ -1,198 +0,0 @@
-/**
- * ═══════════════════════════════════════════════════════════════════════════
- * DO NOT EDIT THIS FILE — IT IS MANAGED AND WILL BE OVERWRITTEN ON UPDATES.
- * ═══════════════════════════════════════════════════════════════════════════
- *
- * This file is the source of truth for the default `oxlint` and `oxfmt`
- * configuration. It is automatically regenerated when the template is
- * updated — any manual changes will be lost.
- *
- * To customize linting rules, edit `oxlint.config.ts`.
- * To customize formatting settings, edit `oxfmt.config.ts`.
- *
- * Those two files are preserved across template updates and are designed
- * to receive user overrides.
- */
-
-import {defineConfig} from 'oxlint';
-import {configs as regexpConfigs} from 'eslint-plugin-regexp';
-
-/** Filter out core ESLint rules bundled into eslint-plugin-regexp recommended config */
-const regexpPluginRules = Object.fromEntries(Object.entries(regexpConfigs.recommended.rules).filter(([key]) => key.startsWith('regexp/')));
-
-const commonIgnore = ['**/.*', 'node_modules/**', 'dist/**', 'build/**', 'coverage/**', 'temp/**', 'public/**', '**/*.md'];
-
-export const linter = defineConfig({
-	options: {
-		typeAware: true,
-		typeCheck: true,
-	},
-	plugins: ['unicorn', 'typescript', 'oxc', 'import', 'react', 'jsdoc', 'promise', 'vitest'],
-	jsPlugins: ['eslint-plugin-regexp'],
-	categories: {
-		correctness: 'error',
-		nursery: 'error',
-		pedantic: 'error',
-		perf: 'error',
-		restriction: 'error',
-		style: 'error',
-		suspicious: 'error',
-	},
-	rules: {
-		...regexpPluginRules,
-		'eslint/capitalized-comments': 'off', // TODO: consider enabling
-		'eslint/complexity': 'off', // TODO: consider enabling
-		'eslint/curly': ['error', 'all'],
-		'eslint/id-length': 'off',
-		'eslint/init-declarations': 'off', // TODO: consider enabling
-		'eslint/max-depth': 'off', // TODO: consider enabling
-		'eslint/max-lines': 'off', // TODO: consider enabling
-		'eslint/max-lines-per-function': 'off', // TODO: consider enabling
-		'eslint/max-params': 'off', // TODO: consider enabling
-		'eslint/max-statements': 'off', // TODO: consider enabling
-		'eslint/no-await-in-loop': 'warn',
-		'eslint/no-console': 'off',
-		'eslint/no-continue': 'off',
-		'eslint/no-inline-comments': 'off',
-		'eslint/no-magic-numbers': 'off',
-		'eslint/no-negated-condition': 'off', // TODO: consider enabling
-		'eslint/no-nested-ternary': 'off',
-		'eslint/no-warning-comments': 'off',
-		'eslint/no-undefined': 'off', // TODO: consider enabling
-		'eslint/no-plusplus': 'off',
-		'eslint/one-var': 'off',
-		'eslint/sort-imports': 'off',
-		'eslint/sort-keys': 'off',
-		'eslint/no-ternary': 'off',
-		'eslint/no-void': ['error', {allowAsStatement: true}],
-		'typescript/consistent-type-definitions': ['error', 'type'],
-		'typescript/dot-notation': ['error', {allowPattern: '^[a-zA-Z]+(_[a-zA-Z]+)+$'}],
-		'typescript/no-import-type-side-effects': 'off',
-		'typescript/no-unused-vars': [
-			'error',
-			{
-				caughtErrors: 'none',
-				argsIgnorePattern: '^_',
-			},
-		],
-		'typescript/prefer-readonly-parameter-types': 'off',
-		'import/consistent-type-specifier-style': ['error', 'prefer-inline'],
-		'import/exports-last': 'off',
-		'import/group-exports': 'off',
-		'import/max-dependencies': 'off',
-		'import/no-named-export': 'off',
-		'import/no-namespace': 'off', // TODO: consider enabling
-		'import/no-nodejs-modules': 'off',
-		'import/no-unassigned-import': ['error', {allow: ['**/*.css']}],
-		'import/prefer-default-export': 'off',
-		'import/no-default-export': 'off',
-		'jsdoc/require-param': 'error',
-		'jsdoc/require-param-type': 'off',
-		'jsdoc/require-returns': 'warn',
-		'jsdoc/require-returns-type': 'off',
-		'oxc/no-async-await': 'off',
-		'oxc/no-map-spread': 'off', // TODO: consider enabling
-		'oxc/no-optional-chaining': 'off',
-		'oxc/no-rest-spread-properties': 'off',
-		'unicorn/escape-case': 'off',
-		'unicorn/filename-case': 'off', // TODO: consider enabling
-		'unicorn/max-nested-calls': ['warn', {max: 5}],
-		'unicorn/no-array-reduce': 'off', // TODO: consider enabling
-		'unicorn/no-array-sort': 'off', // TODO: consider enabling
-		'unicorn/no-hex-escape': 'off',
-		'unicorn/no-immediate-mutation': 'off',
-		'unicorn/no-negated-condition': 'off',
-		'unicorn/no-nested-ternary': 'off',
-		'unicorn/no-null': 'off', // TODO: consider enabling
-		'unicorn/no-process-exit': 'off', // TODO: consider enabling
-		'unicorn/no-typeof-undefined': 'off', // TODO: consider enabling
-		'unicorn/prefer-module': 'off', // TODO: consider enabling
-		'unicorn/prefer-number-coercion': 'off', // TODO: consider enabling
-		'react/function-component-definition': 'off', // TODO: consider enabling
-		'react/jsx-filename-extension': ['error', {extensions: ['.tsx']}],
-		'react/jsx-max-depth': ['error', {max: 5}],
-		'react/jsx-no-literals': 'off',
-		'react/react-in-jsx-scope': 'off',
-		'vitest/max-expects': 'off',
-		'vitest/no-conditional-in-test': 'off',
-		'vitest/no-hooks': 'off',
-		'vitest/no-importing-vitest-globals': 'off',
-		'vitest/prefer-describe-function-title': 'off',
-		'vitest/prefer-expect-assertions': 'off',
-		'vitest/prefer-lowercase-title': 'off',
-		'vitest/prefer-to-be-falsy': 'off', // NOTE: Pick strictness: keep prefer-strict-boolean-matchers, disable truthy/falsy rules.
-		'vitest/prefer-to-be-truthy': 'off', // NOTE: Pick strictness: keep prefer-strict-boolean-matchers, disable truthy/falsy rules.
-		'vitest/require-hook': 'off',
-		'vitest/require-test-timeout': 'off',
-	},
-	overrides: [
-		{
-			// Relax strict type rules for unit tests to allow easier mocking and test scaffolding
-			files: ['**/*.test.ts', '**/*.test.tsx', '**/*.spec.ts', '**/*.spec.tsx'],
-			rules: {
-				'typescript/no-unsafe-type-assertion': 'off',
-				'typescript/no-explicit-any': 'off',
-				'typescript/no-unsafe-assignment': 'off',
-				'typescript/no-unsafe-member-access': 'off',
-				'no-useless-undefined': 'off',
-			},
-		},
-		{
-			files: ['tests/e2e/**/*.e2e-test.ts', '**/*.e2e-test.ts'],
-			rules: {
-				'vitest/prefer-importing-vitest-globals': 'off',
-			},
-		},
-	],
-	settings: {
-		'jsx-a11y': {
-			polymorphicPropName: undefined,
-			components: {},
-			attributes: {},
-		},
-		next: {
-			rootDir: [],
-		},
-		react: {
-			formComponents: [],
-			linkComponents: [],
-			version: undefined,
-		},
-		jsdoc: {
-			ignorePrivate: false,
-			ignoreInternal: false,
-			ignoreReplacesDocs: true,
-			overrideReplacesDocs: true,
-			augmentsExtendsReplacesDocs: false,
-			implementsReplacesDocs: false,
-			exemptDestructuredRootsFromChecks: false,
-			tagNamePreference: {},
-		},
-		vitest: {
-			typecheck: false,
-		},
-	},
-	env: {
-		builtin: true,
-		node: true,
-	},
-	globals: {},
-	ignorePatterns: commonIgnore,
-});
-
-export const formatter = {
-	printWidth: 160,
-	embeddedLanguageFormatting: 'off',
-	useTabs: true,
-	singleQuote: true,
-	bracketSpacing: false,
-	ignorePatterns: commonIgnore,
-	overrides: [
-		{
-			files: ['src/**/*.{scss,css}'],
-			options: {
-				singleQuote: false,
-			},
-		},
-	],
-};

package/oxfmt.config.ts

@@ -1,9 +0,0 @@
-import {formatter as defaults} from './oxc.config.ts';
-
-// Add custom oxfmt formatter overrides here.
-// This file is preserved on template updates.
-const formatter: Partial<typeof defaults> = {};
-
-const config = {...defaults, ...formatter};
-
-export default config;

package/oxlint.config.ts

@@ -1,36 +0,0 @@
-import {linter as defaults} from './oxc.config.ts';
-
-// Add custom oxlint rule overrides here.
-// This file is preserved on template updates.
-//
-// Example:
-//   rules: { 'no-console': 'off' }
-//   overrides: [{ files: ['scripts/**'], rules: { 'no-console': 'off' } }]
-const rules = {
-	'eslint/func-style': 'off',
-	'typescript/promise-function-async': 'off',
-	'unicorn/max-nested-calls': ['warn', {max: 20}],
-};
-const overrides = [
-	{
-		files: ['src/client/**'],
-		env: {browser: true},
-		rules: {
-			'typescript/no-unsafe-type-assertion': 'off',
-		},
-	},
-	{
-		files: ['src/gather.ts'],
-		rules: {
-			'promise/avoid-new': 'off',
-		},
-	},
-];
-
-const config = {
-	...defaults,
-	rules: {...defaults.rules, ...rules},
-	overrides: [...defaults.overrides, ...overrides],
-};
-
-export default config;

package/src/aggregation.test.ts

@@ -1,118 +0,0 @@
-import {describe, expect, it} from 'vitest';
-import {aggregate, resolveRange} from './aggregation.js';
-import {type Commit} from './model.js';
-
-const commits: Commit[] = [
-	{revision: 1, author: 'ada', date: '2025-03-01T23:30:00.000Z', message: 'a'},
-	{revision: 2, author: 'ada', date: '2026-02-28T00:00:00.000Z', message: 'b'},
-	{revision: 3, author: null, date: '2026-03-01T01:00:00.000Z', message: 'c'},
-];
-
-describe('UTC date ranges and aggregation', () => {
-	it('uses deterministic relative UTC dates', () => {
-		expect(resolveRange(commits, {relativeDays: 30}, new Date('2026-03-01T23:59:59Z'))).toStrictEqual({from: '2026-01-31', to: '2026-03-01'});
-	});
-
-	it('rejects conflicts, invalid dates, and reversed dates', () => {
-		expect(() => resolveRange(commits, {from: '2026-01-01', relativeDays: 2})).toThrow('cannot be used');
-		expect(() => resolveRange(commits, {from: '2026-02-30'})).toThrow('Invalid UTC date');
-		expect(() => resolveRange(commits, {from: '2026-03-02', to: '2026-03-01'})).toThrow('after end date');
-		expect(() => resolveRange(commits, {relativeDays: 0})).toThrow('positive integer');
-	});
-
-	it('defaults to dataset bounds and today for empty data', () => {
-		expect(resolveRange(commits, {}, new Date('2030-01-01T00:00:00Z'))).toStrictEqual({from: '2025-03-01', to: '2026-03-01'});
-		expect(resolveRange([], {}, new Date('2026-04-05T22:00:00Z'))).toStrictEqual({from: '2026-04-05', to: '2026-04-05'});
-	});
-
-	it('produces UTC charts with exactly 30 days and 12 anchored months', () => {
-		const result = aggregate(commits, {from: '2025-03-01', to: '2026-03-01'});
-		expect(result.days.labels).toHaveLength(30);
-		expect(result.days.labels[0]).toBe('2026-01-31');
-		expect(result.days.labels.at(-1)).toBe('2026-03-01');
-		expect(result.months.labels).toHaveLength(12);
-		expect(result.months.labels).toStrictEqual([
-			'2025-04',
-			'2025-05',
-			'2025-06',
-			'2025-07',
-			'2025-08',
-			'2025-09',
-			'2025-10',
-			'2025-11',
-			'2025-12',
-			'2026-01',
-			'2026-02',
-			'2026-03',
-		]);
-		expect(result.weekdays.values.reduce((sum, count) => sum + count, 0)).toBe(3);
-		expect(result.hours.values[23]).toBe(1);
-		expect(result.users).toStrictEqual({labels: ['ada', '(no author)'], values: [2, 1]});
-	});
-
-	it('produces a stacked commits-per-day-and-user series over the same 30 days', () => {
-		const result = aggregate(commits, {from: '2025-03-01', to: '2026-03-01'});
-		expect(result.daysByUser.labels).toStrictEqual(result.days.labels);
-		expect(result.daysByUser.datasets).toHaveLength(2);
-		const ada = result.daysByUser.datasets.find((dataset) => dataset.label === 'ada');
-		const noAuthor = result.daysByUser.datasets.find((dataset) => dataset.label === '(no author)');
-		expect(ada?.values.reduce((sum, count) => sum + count, 0)).toBe(1);
-		expect(noAuthor?.values.reduce((sum, count) => sum + count, 0)).toBe(1);
-		expect(noAuthor?.values.at(-1)).toBe(1);
-	});
-
-	it('stacks the top-10 buckets for commits per day and user', () => {
-		const many = Array.from({length: 12}, (_, index) => ({
-			revision: index + 1,
-			author: `user${String(index).padStart(2, '0')}`,
-			date: '2026-03-01T00:00:00.000Z',
-			message: 'm',
-		}));
-		const result = aggregate(many, {from: '2026-03-01', to: '2026-03-01'});
-		expect(result.daysByUser.datasets).toHaveLength(11);
-		expect(result.daysByUser.datasets.map((dataset) => dataset.label)).toStrictEqual([
-			'user00',
-			'user01',
-			'user02',
-			'user03',
-			'user04',
-			'user05',
-			'user06',
-			'user07',
-			'user08',
-			'user09',
-			'(others)',
-		]);
-		const others = result.daysByUser.datasets.at(-1);
-		expect(others?.values.at(-1)).toBe(2);
-	});
-
-	it('caps contributors at 10 and buckets the remainder into "(others)"', () => {
-		const many = Array.from({length: 12}, (_, index) => ({
-			revision: index + 1,
-			author: `user${String(index).padStart(2, '0')}`,
-			date: '2026-03-01T00:00:00.000Z',
-			message: 'm',
-		}));
-		const result = aggregate(many, {from: '2026-03-01', to: '2026-03-01'});
-		expect(result.users.labels).toHaveLength(11);
-		expect(result.users.labels.slice(0, 10)).toStrictEqual(Array.from({length: 10}, (_, index) => `user${String(index).padStart(2, '0')}`));
-		expect(result.users.labels.at(-1)).toBe('(others)');
-		expect(result.users.values.at(-1)).toBe(2);
-	});
-
-	it('returns the 20 most recent commits within the range, newest first', () => {
-		const many: Commit[] = Array.from({length: 25}, (_, index) => ({
-			revision: index + 1,
-			author: 'ada',
-			date: `2026-01-${String(index + 1).padStart(2, '0')}T00:00:00.000Z`,
-			message: `m${index}`,
-		}));
-		many.push({revision: 26, author: 'lin', date: '2025-12-31T00:00:00.000Z', message: 'outside'});
-		const result = aggregate(many, {from: '2026-01-01', to: '2026-01-31'});
-		expect(result.recent).toHaveLength(20);
-		expect(result.recent[0]?.revision).toBe(25);
-		expect(result.recent.at(-1)?.revision).toBe(6);
-		expect(result.recent.some((commit) => commit.revision === 26)).toBe(false);
-	});
-});

package/src/aggregation.ts

@@ -1,198 +0,0 @@
-import {z} from 'zod';
-import {type Commit} from './model.js';
-
-const DAY_MS = 86_400_000;
-const dateTextSchema = z.string().regex(/^\d{4}-\d{2}-\d{2}$/u, 'Expected YYYY-MM-DD');
-
-export const DEFAULT_CONTRIBUTORS = 10;
-export const DEFAULT_RECENT = 20;
-export const OTHER_CONTRIBUTORS_LABEL = '(others)';
-
-export type DateRange = {readonly from: string; readonly to: string};
-export type Series = {readonly labels: string[]; readonly values: number[]};
-export type StackedDataset = {readonly label: string; readonly values: number[]};
-export type StackedSeries = {readonly labels: string[]; readonly datasets: StackedDataset[]};
-export type ReportData = {
-	readonly range: DateRange;
-	readonly total: number;
-	readonly users: Series;
-	readonly weekdays: Series;
-	readonly hours: Series;
-	readonly days: Series;
-	readonly daysByUser: StackedSeries;
-	readonly months: Series;
-	readonly recent: Commit[];
-};
-
-function parseDateText(value: string): Date {
-	dateTextSchema.parse(value);
-	const date = new Date(`${value}T00:00:00.000Z`);
-	if (Number.isNaN(date.getTime()) || date.toISOString().slice(0, 10) !== value) {
-		throw new Error(`Invalid UTC date: ${value}`);
-	}
-	return date;
-}
-
-function dateText(date: Date): string {
-	return date.toISOString().slice(0, 10);
-}
-
-function addDays(value: string, amount: number): string {
-	const date = parseDateText(value);
-	return dateText(new Date(date.getTime() + amount * DAY_MS));
-}
-
-function datasetBounds(commits: readonly Commit[], today: string): DateRange {
-	if (commits.length === 0) {
-		return {from: today, to: today};
-	}
-	const dates = commits.map((commit) => commit.date.slice(0, 10)).sort();
-	const [first] = dates;
-	const last = dates.at(-1);
-	if (first === undefined || last === undefined) {
-		return {from: today, to: today};
-	}
-	return {from: first, to: last};
-}
-
-export function resolveRange(
-	commits: readonly Commit[],
-	options: {readonly from?: string | undefined; readonly to?: string | undefined; readonly relativeDays?: number | undefined},
-	now = new Date(),
-): DateRange {
-	const today = dateText(now);
-	parseDateText(today);
-	if (options.relativeDays !== undefined) {
-		if (options.from !== undefined || options.to !== undefined) {
-			throw new Error('--from/--to cannot be used with --relative-days');
-		}
-		if (!Number.isInteger(options.relativeDays) || options.relativeDays <= 0) {
-			throw new Error('--relative-days must be a positive integer');
-		}
-		return {from: addDays(today, 1 - options.relativeDays), to: today};
-	}
-	const bounds = datasetBounds(commits, today);
-	const from = options.from ?? bounds.from;
-	const to = options.to ?? bounds.to;
-	parseDateText(from);
-	parseDateText(to);
-	if (from > to) {
-		throw new Error(`Report start date ${from} is after end date ${to}`);
-	}
-	return {from, to};
-}
-
-function countSeries(labels: readonly string[], keys: readonly string[]): Series {
-	const counts = new Map(labels.map((label) => [label, 0]));
-	for (const key of keys) {
-		if (counts.has(key)) {
-			counts.set(key, (counts.get(key) ?? 0) + 1);
-		}
-	}
-	return {labels: [...labels], values: labels.map((label) => counts.get(label) ?? 0)};
-}
-
-function countStackedSeries(
-	labels: readonly string[],
-	buckets: readonly string[],
-	entries: readonly {readonly key: string; readonly bucket: string}[],
-): StackedSeries {
-	const bucketValues = new Map(buckets.map((bucket) => [bucket, Array.from({length: labels.length}, () => 0)]));
-	const indexByLabel = new Map(labels.map((label, index) => [label, index]));
-	for (const {key, bucket} of entries) {
-		const values = bucketValues.get(bucket);
-		const index = indexByLabel.get(key);
-		if (values === undefined || index === undefined) {
-			continue;
-		}
-		values[index] = (values[index] ?? 0) + 1;
-	}
-	return {labels: [...labels], datasets: buckets.map((bucket) => ({label: bucket, values: [...(bucketValues.get(bucket) ?? [])]}))};
-}
-
-function monthLabels(end: string): string[] {
-	const endDate = parseDateText(end);
-	const result: string[] = [];
-	for (let offset = 11; offset >= 0; offset--) {
-		result.push(dateText(new Date(Date.UTC(endDate.getUTCFullYear(), endDate.getUTCMonth() - offset, 1))).slice(0, 7));
-	}
-	return result;
-}
-
-export function aggregate(commits: readonly Commit[], range: DateRange): ReportData {
-	parseDateText(range.from);
-	parseDateText(range.to);
-	if (range.from > range.to) {
-		throw new Error('Report date range is reversed');
-	}
-	const selected = commits.filter((commit) => {
-		const date = commit.date.slice(0, 10);
-		return date >= range.from && date <= range.to;
-	});
-
-	const userCounts = new Map<string, number>();
-	for (const commit of selected) {
-		const author = commit.author === null || commit.author === '' ? '(no author)' : commit.author;
-		userCounts.set(author, (userCounts.get(author) ?? 0) + 1);
-	}
-	const ranked = [...userCounts.entries()].sort(
-		([leftName, leftCount], [rightName, rightCount]) => rightCount - leftCount || leftName.localeCompare(rightName),
-	);
-	let userLabels: string[];
-	let userValues: number[];
-	const bucketOf = new Map<string, string>();
-	if (ranked.length > DEFAULT_CONTRIBUTORS) {
-		const top = ranked.slice(0, DEFAULT_CONTRIBUTORS);
-		const others = ranked.slice(DEFAULT_CONTRIBUTORS).reduce((sum, [, count]) => sum + count, 0);
-		userLabels = [...top.map(([name]) => name), OTHER_CONTRIBUTORS_LABEL];
-		userValues = [...top.map(([, count]) => count), others];
-		for (const [name] of top) {
-			bucketOf.set(name, name);
-		}
-		for (const [name] of ranked.slice(DEFAULT_CONTRIBUTORS)) {
-			bucketOf.set(name, OTHER_CONTRIBUTORS_LABEL);
-		}
-	} else {
-		userLabels = ranked.map(([name]) => name);
-		userValues = ranked.map(([, count]) => count);
-		for (const [name] of ranked) {
-			bucketOf.set(name, name);
-		}
-	}
-	const weekdayLabels = ['Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday', 'Sunday'];
-	const hourLabels = Array.from({length: 24}, (_, hour) => hour.toString().padStart(2, '0'));
-	const dayLabels = Array.from({length: 30}, (_, index) => addDays(range.to, index - 29));
-	const months = monthLabels(range.to);
-	const recent = [...selected].sort((left, right) => right.revision - left.revision).slice(0, DEFAULT_RECENT);
-	const daysByUser = countStackedSeries(
-		dayLabels,
-		userLabels,
-		selected.map((commit) => {
-			const author = commit.author === null || commit.author === '' ? '(no author)' : commit.author;
-			return {key: commit.date.slice(0, 10), bucket: bucketOf.get(author) ?? OTHER_CONTRIBUTORS_LABEL};
-		}),
-	);
-	return {
-		range,
-		total: selected.length,
-		users: {labels: userLabels, values: userValues},
-		weekdays: countSeries(
-			weekdayLabels,
-			selected.map((commit) => weekdayLabels[(new Date(commit.date).getUTCDay() + 6) % 7] ?? 'Monday'),
-		),
-		hours: countSeries(
-			hourLabels,
-			selected.map((commit) => new Date(commit.date).getUTCHours().toString().padStart(2, '0')),
-		),
-		days: countSeries(
-			dayLabels,
-			selected.map((commit) => commit.date.slice(0, 10)),
-		),
-		daysByUser,
-		months: countSeries(
-			months,
-			selected.map((commit) => commit.date.slice(0, 7)),
-		),
-		recent,
-	};
-}

package/src/cli.test.ts

@@ -1,10 +0,0 @@
-import {readFileSync} from 'node:fs';
-import {describe, expect, it} from 'vitest';
-import {createProgram} from './cli.js';
-
-describe('CLI', () => {
-	it('reports the package version', () => {
-		const packageJson = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')) as {version: string};
-		expect(createProgram().version()).toBe(packageJson.version);
-	});
-});

package/src/cli.ts

@@ -1,61 +0,0 @@
-import {Command, Option} from 'commander';
-import {gather, type GatherOptions} from './gather.js';
-import {generate, type GenerateOptions} from './report.js';
-
-declare const APP_VERSION: string;
-
-type CommonGatherOptions = Omit<GatherOptions, 'url'> & {readonly url: string};
-
-function positiveInteger(value: string): number {
-	const parsed = Number(value);
-	if (!Number.isInteger(parsed) || parsed <= 0) {
-		throw new Error('Expected a positive integer');
-	}
-	return parsed;
-}
-
-function gatherOptions(command: Command): Command {
-	return command
-		.requiredOption('--url <url>', 'SVN repository URL')
-		.option('--username <username>', 'SVN username')
-		.option('--password-env <name>', 'environment variable containing the SVN password', 'SVN_PASSWORD')
-		.option('--data-file <path>', 'JSON state file', 'svn-data.json')
-		.option('--svn-binary <path>', 'SVN executable', 'svn');
-}
-
-function generateOptions(command: Command, includeDataFile = true): Command {
-	if (includeDataFile) {
-		command.option('--data-file <path>', 'JSON state file', 'svn-data.json');
-	}
-	return command
-		.option('--output-dir <path>', 'report output directory', 'output')
-		.option('--from <date>', 'first UTC date (YYYY-MM-DD)')
-		.option('--to <date>', 'last UTC date (YYYY-MM-DD)')
-		.addOption(new Option('--relative-days <days>', 'rolling number of UTC days').argParser(positiveInteger))
-		.option('--title <title>', 'report title', 'Subversion activity');
-}
-
-export function createProgram(): Command {
-	const program = new Command().name('svn-visualizer').description('Generate standalone HTML activity reports from Subversion history').version(APP_VERSION);
-
-	gatherOptions(program.command('gather').description('Incrementally gather SVN history')).action(async (options: CommonGatherOptions) => {
-		const result = await gather(options);
-		console.log(result.added === 0 ? 'No new commits.' : `Gathered ${String(result.added)} new commit(s).`);
-	});
-
-	generateOptions(program.command('generate').description('Generate a standalone HTML report')).action(async (options: GenerateOptions) => {
-		const output = await generate(options);
-		console.log(`Generated ${output}`);
-	});
-
-	generateOptions(gatherOptions(program.command('report').description('Gather history and generate a report')), false).action(
-		async (options: CommonGatherOptions & GenerateOptions) => {
-			const result = await gather(options);
-			console.log(result.added === 0 ? 'No new commits.' : `Gathered ${String(result.added)} new commit(s).`);
-			const output = await generate(options);
-			console.log(`Generated ${output}`);
-		},
-	);
-
-	return program;
-}