tablinum 0.0.1 → 0.1.1

package/.context/attachments/pasted_text_2026-03-07_14-02-40.txt

@@ -1,571 +0,0 @@
-import { exec, type ChildProcess } from 'node:child_process';
-import { existsSync, readFileSync, readdirSync } from 'node:fs';
-import { basename, dirname, join } from 'node:path';
-
-interface ValidationError {
-	tool: string;
-	file?: string;
-	line?: number;
-	column?: number;
-	message: string;
-	code?: string;
-	severity: 'error' | 'warning';
-}
-
-interface ValidationResult {
-	success: boolean;
-	errors: ValidationError[];
-	summary: string;
-	duration_ms: number;
-	stopped_early: boolean;
-	next_action?: string;
-}
-
-const MAX_ERRORS = 3;
-const E2E_SKIP_RUNTIME = process.env.VALIDATE_SKIP_E2E_RUNTIME === '1';
-const ANSI_ESCAPE_PATTERN = new RegExp(String.raw`\u001B\[[0-9;?]*[A-Za-z]`, 'g');
-
-// Shared state for fail-fast behavior
-let collectedErrors: ValidationError[] = [];
-let failedTools: string[] = [];
-let aborted = false;
-const runningProcesses: ChildProcess[] = [];
-
-function abort() {
-	aborted = true;
-	// Kill all running child processes
-	for (const proc of runningProcesses) {
-		proc.kill('SIGTERM');
-	}
-}
-
-function addErrors(toolName: string, errors: ValidationError[]): boolean {
-	if (aborted || errors.length === 0) return aborted;
-
-	if (!failedTools.includes(toolName)) {
-		failedTools.push(toolName);
-	}
-
-	for (const error of errors) {
-		if (collectedErrors.length >= MAX_ERRORS) {
-			abort();
-			return true;
-		}
-		collectedErrors.push(error);
-	}
-
-	if (collectedErrors.length >= MAX_ERRORS) {
-		abort();
-		return true;
-	}
-
-	return false;
-}
-
-function run(cmd: string): Promise<{ stdout: string; stderr: string; success: boolean }> {
-	return new Promise((resolve) => {
-		if (aborted) {
-			resolve({ stdout: '', stderr: '', success: false });
-			return;
-		}
-
-		const proc = exec(
-			cmd,
-			{ encoding: 'utf-8', maxBuffer: 10 * 1024 * 1024 },
-			(error, stdout, stderr) => {
-				const idx = runningProcesses.indexOf(proc);
-				if (idx !== -1) runningProcesses.splice(idx, 1);
-
-				if (aborted) {
-					resolve({ stdout: '', stderr: '', success: false });
-					return;
-				}
-
-				resolve({
-					stdout: stdout ?? '',
-					stderr: stderr ?? '',
-					success: !error
-				});
-			}
-		);
-
-		runningProcesses.push(proc);
-	});
-}
-
-function summarizeFailureOutput(text: string): string | undefined {
-	const lines = normalizeOutputLines(text);
-
-	if (lines.length === 0) return undefined;
-
-	const prioritized = lines.find((line) =>
-		/(^error\b|failed|ELIFECYCLE|\[WebServer\])/i.test(line)
-	);
-	return prioritized ?? lines[0];
-}
-
-function normalizeOutputLines(text: string): string[] {
-	return text
-		.split('\n')
-		.map((line) => line.replace(ANSI_ESCAPE_PATTERN, '').trim())
-		.filter((line) => line.length > 0);
-}
-
-function truncateText(text: string, maxLength = 220): string {
-	return text.length <= maxLength ? text : `${text.slice(0, maxLength - 1)}...`;
-}
-
-function summarizePlaywrightFailure(text: string): string | undefined {
-	const lines = normalizeOutputLines(text);
-	const failureIndex = lines.findIndex((line) => /^\d+\)\s+\[[^\]]+\]\s+›/.test(line));
-	const failureLine = failureIndex >= 0 ? lines[failureIndex] : undefined;
-	const detailLine =
-		(failureIndex >= 0 &&
-			lines
-				.slice(failureIndex + 1)
-				.find((line) => /^Error:/i.test(line) || /expect\(.+\)\..+\sfailed/i.test(line))) ??
-		lines.find((line) => /^Error:/i.test(line));
-
-	if (failureLine && detailLine) {
-		return truncateText(`${failureLine} :: ${detailLine}`);
-	}
-
-	if (failureLine) {
-		return truncateText(failureLine);
-	}
-
-	return undefined;
-}
-
-function countListedTestsForProject(output: string, projectName: string): number {
-	return output
-		.split('\n')
-		.map((line) => line.trim())
-		.filter((line) => line.startsWith(`[${projectName}]`) && line.includes('›')).length;
-}
-
-async function runTestCoverage(): Promise<ValidationError[]> {
-	if (aborted) return [];
-	const errors: ValidationError[] = [];
-
-	const { stdout } = await run('git ls-files "src/**/*.ts" "src/**/*.svelte"');
-	if (aborted) return [];
-
-	const sourceFiles = stdout.split('\n').filter(Boolean);
-
-	const skipPatterns = [
-		/\.test\.ts$/,
-		/\.spec\.ts$/,
-		/\.d\.ts$/,
-		/index\.ts$/,
-		/types\.ts$/,
-		/\.styles\.ts$/,
-		/\.stories\.svelte$/,
-		/\.test-wrapper\.svelte$/,
-		/\+error\.svelte$/,
-		/\/data\/Data\.svelte$/,
-		/\.remote\.ts$/,
-		/\/server\/auth\.ts$/,
-		/\/server\/access\.ts$/,
-		/\/server\/auth-guards\.ts$/,
-		/\/server\/db\/schema\//,
-		/\/testing\/mocks\.ts$/,
-		/\+layout\.(server\.)?ts$/,
-		/\+layout\.svelte$/,
-		/\+page\.server\.ts$/,
-		/\+page\.svelte$/,
-		/\+page\.ts$/
-	];
-
-	for (const file of sourceFiles) {
-		if (aborted) break;
-		if (skipPatterns.some((p) => p.test(file))) continue;
-
-		const dir = dirname(file);
-		const name = basename(file).replace(/\.(ts|svelte)$/, '');
-		const alternateName = name.startsWith('+') ? name.slice(1) : null;
-
-		const testPaths = [
-			join(dir, `${name}.test.ts`),
-			join(dir, `${name}.spec.ts`),
-			join(dir, `${name}.svelte.test.ts`),
-			join(dir, `${name}.svelte.spec.ts`),
-			join(dir, `${name}.ssr.test.ts`),
-			join(dir, `${name}.ssr.spec.ts`),
-			join(dir, '__tests__', `${name}.test.ts`),
-			join(dir, '__tests__', `${name}.spec.ts`)
-		];
-		if (alternateName) {
-			testPaths.push(
-				join(dir, `${alternateName}.test.ts`),
-				join(dir, `${alternateName}.spec.ts`),
-				join(dir, '__tests__', `${alternateName}.test.ts`),
-				join(dir, '__tests__', `${alternateName}.spec.ts`)
-			);
-		}
-
-		const hasTest = testPaths.some((p) => existsSync(p));
-
-		if (!hasTest) {
-			errors.push({
-				tool: 'test-coverage',
-				file,
-				severity: 'error',
-				message: `Missing test file. Expected: ${name}.test.ts${alternateName ? ` or ${alternateName}.test.ts` : ''}`
-			});
-		}
-	}
-
-	return errors;
-}
-
-async function runPrettier(): Promise<ValidationError[]> {
-	if (aborted) return [];
-	const errors: ValidationError[] = [];
-	const { stdout, success } = await run(
-		'pnpm exec prettier --check --plugin prettier-plugin-svelte .'
-	);
-
-	if (aborted) return [];
-
-	if (!success) {
-		for (const line of stdout.split('\n')) {
-			if (line.startsWith('[warn]') || line.includes('Forgot to run') || line.includes('Checking'))
-				continue;
-			if (line.trim()) {
-				errors.push({
-					tool: 'prettier',
-					file: line.trim(),
-					severity: 'error',
-					message: 'File needs formatting. Run: pnpm exec prettier --write ' + line.trim()
-				});
-			}
-		}
-	}
-
-	return errors;
-}
-
-async function runOxlint(): Promise<ValidationError[]> {
-	if (aborted) return [];
-	const errors: ValidationError[] = [];
-	const { stdout } = await run('pnpm exec oxlint --format json');
-
-	if (aborted) return [];
-
-	try {
-		// oxlint outputs JSON with diagnostics array
-		const result = JSON.parse(stdout);
-		for (const diagnostic of result.diagnostics ?? []) {
-			if (diagnostic.severity === 'error') {
-				const label = diagnostic.labels?.[0];
-				errors.push({
-					tool: 'oxlint',
-					file: diagnostic.filename,
-					line: label?.span?.line,
-					column: label?.span?.column,
-					code: diagnostic.code,
-					severity: 'error',
-					message: diagnostic.message
-				});
-			}
-		}
-	} catch {
-		// JSON parse failed, no errors to report
-	}
-
-	return errors;
-}
-
-async function runSvelteCheck(): Promise<ValidationError[]> {
-	if (aborted) return [];
-	const errors: ValidationError[] = [];
-	const { stdout } = await run('pnpm exec svelte-check --output machine-verbose');
-
-	if (aborted) return [];
-
-	for (const line of stdout.split('\n')) {
-		const match = line.match(/^(\w+)\s+(.+):(\d+):(\d+)\s+(.+)$/);
-		if (match && match[1] === 'ERROR') {
-			errors.push({
-				tool: 'svelte-check',
-				file: match[2],
-				line: parseInt(match[3]),
-				column: parseInt(match[4]),
-				severity: 'error',
-				message: match[5]
-			});
-		}
-	}
-
-	return errors;
-}
-
-async function runTypeScript(): Promise<ValidationError[]> {
-	if (aborted) return [];
-	const errors: ValidationError[] = [];
-	const { stdout } = await run('pnpm exec tsc --noEmit --pretty false');
-
-	if (aborted) return [];
-
-	for (const line of stdout.split('\n')) {
-		const match = line.match(/^(.+)\((\d+),(\d+)\):\s+error\s+(TS\d+):\s+(.+)$/);
-		if (match) {
-			errors.push({
-				tool: 'tsc',
-				file: match[1],
-				line: parseInt(match[2]),
-				column: parseInt(match[3]),
-				code: match[4],
-				severity: 'error',
-				message: match[5]
-			});
-		}
-	}
-
-	return errors;
-}
-
-const E2E_REQUIRED_ROUTES = ['/', '/login', '/login/check-email', '/account', '/dashboard'];
-const E2E_MIN_CHROMIUM_TESTS = 10;
-const E2E_MIN_CHROMIUM_AUTH_TESTS = 1;
-
-async function runE2ECoverage(): Promise<ValidationError[]> {
-	if (aborted) return [];
-	const errors: ValidationError[] = [];
-	const e2eDir = 'e2e';
-
-	if (!existsSync(e2eDir)) {
-		errors.push({
-			tool: 'e2e-coverage',
-			severity: 'error',
-			message: 'Missing e2e/ directory. Run: mkdir e2e'
-		});
-		return errors;
-	}
-
-	// Run Playwright discovery for chromium.
-	const {
-		stdout: chromiumListStdout,
-		stderr: chromiumListStderr,
-		success: chromiumListSuccess
-	} = await run('pnpm exec playwright test --project=chromium --list');
-	if (aborted) return [];
-
-	if (!chromiumListSuccess) {
-		const output = `${chromiumListStderr}\n${chromiumListStdout}`.trim();
-		const firstLine = summarizeFailureOutput(output);
-		errors.push({
-			tool: 'e2e-coverage',
-			severity: 'error',
-			message: `Playwright chromium discovery failed${firstLine ? `: ${firstLine}` : ''}`
-		});
-		return errors;
-	}
-
-	const chromiumTotal = countListedTestsForProject(chromiumListStdout, 'chromium');
-
-	if (chromiumTotal < E2E_MIN_CHROMIUM_TESTS) {
-		errors.push({
-			tool: 'e2e-coverage',
-			severity: 'error',
-			message: `Chromium E2E test count too low (${chromiumTotal}). Minimum required: ${E2E_MIN_CHROMIUM_TESTS}`
-		});
-	}
-
-	// Ensure authenticated project is still covered.
-	const {
-		stdout: chromiumAuthListStdout,
-		stderr: chromiumAuthListStderr,
-		success: chromiumAuthListSuccess
-	} = await run('pnpm exec playwright test --project=chromium-auth --list');
-	if (aborted) return [];
-
-	if (!chromiumAuthListSuccess) {
-		const output = `${chromiumAuthListStderr}\n${chromiumAuthListStdout}`.trim();
-		const firstLine = summarizeFailureOutput(output);
-		errors.push({
-			tool: 'e2e-coverage',
-			severity: 'error',
-			message: `Playwright chromium-auth discovery failed${firstLine ? `: ${firstLine}` : ''}`
-		});
-		return errors;
-	}
-
-	const chromiumAuthTotal = countListedTestsForProject(chromiumAuthListStdout, 'chromium-auth');
-
-	if (chromiumAuthTotal < E2E_MIN_CHROMIUM_AUTH_TESTS) {
-		errors.push({
-			tool: 'e2e-coverage',
-			severity: 'error',
-			message: `Chromium-auth E2E test count too low (${chromiumAuthTotal}). Minimum required: ${E2E_MIN_CHROMIUM_AUTH_TESTS}`
-		});
-	}
-
-	const testFiles: string[] = [];
-	const walk = (dir: string) => {
-		for (const entry of readdirSync(dir, { withFileTypes: true })) {
-			const fullPath = join(dir, entry.name);
-			if (entry.isDirectory()) {
-				walk(fullPath);
-				continue;
-			}
-			if (entry.isFile() && entry.name.endsWith('.spec.ts')) {
-				testFiles.push(fullPath);
-			}
-		}
-	};
-	walk(e2eDir);
-
-	if (testFiles.length === 0) {
-		errors.push({
-			tool: 'e2e-coverage',
-			severity: 'error',
-			message: 'No E2E test files found in e2e/ directory'
-		});
-		return errors;
-	}
-
-	const testedRoutes = new Set<string>();
-	for (const file of testFiles) {
-		const content = readFileSync(file, 'utf-8');
-		const matches = content.matchAll(/page\.goto\(['"]([^'"]+)['"]\)/g);
-		for (const match of matches) {
-			testedRoutes.add(match[1]);
-		}
-	}
-
-	for (const route of E2E_REQUIRED_ROUTES) {
-		if (!testedRoutes.has(route)) {
-			errors.push({
-				tool: 'e2e-coverage',
-				severity: 'error',
-				message: `Missing E2E test for critical route: ${route}`
-			});
-		}
-	}
-
-	return errors;
-}
-
-async function runE2EChromium(): Promise<ValidationError[]> {
-	if (aborted || E2E_SKIP_RUNTIME) return [];
-
-	const errors: ValidationError[] = [];
-	const { stdout, stderr, success } = await run(
-		'pnpm exec playwright test --project=chromium --workers=1 --reporter=line'
-	);
-
-	if (aborted) return [];
-
-	if (!success) {
-		const output = `${stderr}\n${stdout}`.trim();
-		const firstLine = summarizePlaywrightFailure(output) ?? summarizeFailureOutput(output);
-		errors.push({
-			tool: 'e2e-chromium',
-			severity: 'error',
-			message: `Chromium E2E run failed${firstLine ? `: ${firstLine}` : ''}`
-		});
-	}
-
-	return errors;
-}
-
-async function runVitest(): Promise<ValidationError[]> {
-	if (aborted) return [];
-	const errors: ValidationError[] = [];
-	const { stdout } = await run('pnpm exec vitest run --reporter=json');
-
-	if (aborted) return [];
-
-	try {
-		const result = JSON.parse(stdout);
-		for (const file of result.testResults ?? []) {
-			for (const test of file.assertionResults ?? []) {
-				if (test.status === 'failed') {
-					errors.push({
-						tool: 'vitest',
-						file: file.name,
-						line: test.location?.line,
-						severity: 'error',
-						message: `${test.ancestorTitles.join(' > ')} > ${test.title}: ${test.failureMessages?.[0]?.split('\n')[0] ?? 'failed'}`
-					});
-				}
-			}
-		}
-	} catch {
-		// JSON parse failed, no errors to report
-	}
-
-	return errors;
-}
-
-interface Check {
-	name: string;
-	fn: () => Promise<ValidationError[]>;
-}
-
-async function validate(): Promise<ValidationResult> {
-	const start = performance.now();
-
-	// Reset global state
-	collectedErrors = [];
-	failedTools = [];
-	aborted = false;
-
-	const allChecks: Check[] = [
-		{ name: 'prettier', fn: runPrettier },
-		{ name: 'oxlint', fn: runOxlint },
-		{ name: 'svelte-check', fn: runSvelteCheck },
-		{ name: 'tsc', fn: runTypeScript },
-		{ name: 'test-coverage', fn: runTestCoverage },
-		{ name: 'e2e-coverage', fn: runE2ECoverage },
-		{ name: 'vitest', fn: runVitest }
-	];
-
-	if (!E2E_SKIP_RUNTIME) {
-		allChecks.push({ name: 'e2e-chromium', fn: runE2EChromium });
-	}
-
-	console.error(`→ Running ${allChecks.length} checks in parallel...`);
-
-	// Run all checks in parallel with fail-fast
-	await Promise.all(
-		allChecks.map(async (check) => {
-			const checkStart = performance.now();
-			const errors = await check.fn();
-			const checkDuration = Math.round(performance.now() - checkStart);
-
-			// Add errors and check if we should abort
-			const wasAborted = addErrors(check.name, errors);
-
-			const status = aborted && errors.length === 0 ? '○' : errors.length === 0 ? '✓' : '✗';
-			const suffix = wasAborted && errors.length === 0 ? ' (cancelled)' : '';
-			console.error(`  ${status} ${check.name} (${checkDuration}ms)${suffix}`);
-		})
-	);
-
-	const duration_ms = Math.round(performance.now() - start);
-
-	const errorSummary = `✗ ${collectedErrors.length} error(s) from ${failedTools.join(', ')}`;
-
-	return {
-		success: collectedErrors.length === 0,
-		errors: collectedErrors,
-		summary:
-			collectedErrors.length === 0
-				? `✓ All ${allChecks.length} checks passed in ${duration_ms}ms`
-				: errorSummary,
-		duration_ms,
-		stopped_early: aborted,
-		next_action:
-			collectedErrors.length > 0
-				? 'Spawn a sub-agent to fix these errors, then re-run validation.'
-				: undefined
-	};
-}
-
-validate().then((result) => {
-	console.log(JSON.stringify(result, null, 2));
-	process.exit(result.success ? 0 : 1);
-});