Improve settings (#168)

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

frontend/local-client-cli/src/args.ts

@@ -12,6 +12,8 @@ export interface CliArgs {
 	ignorePatterns?: string[];
 	webSocketRetryIntervalMs?: number;
 	logLevel: LogLevel;
+	health?: string;
+	enableTelemetry?: boolean;
 }
 
 export function parseArgs(argv: string[]): CliArgs {
@@ -51,6 +53,14 @@ export function parseArgs(argv: string[]): CliArgs {
 			"[OPTIONAL] Log level (DEBUG, INFO, WARNING, ERROR)",
 			"INFO"
 		)
+		.option(
+			"--health <path>",
+			"[OPTIONAL] Path to health status file for Docker healthcheck"
+		)
+		.option(
+			"--enable-telemetry",
+			"[OPTIONAL] Enable telemetry (disabled by default)"
+		)
 		.addHelpText(
 			"after",
 			`
@@ -78,6 +88,8 @@ Examples:
 		| number
 		| undefined;
 	const logLevelStr = (opts.logLevel as string | undefined) ?? "INFO";
+	const health = opts.health as string | undefined;
+	const enableTelemetry = opts.enableTelemetry as boolean | undefined;
 	/* eslint-enable @typescript-eslint/no-unsafe-type-assertion */
 
 	if (localPath === undefined) {
@@ -117,6 +129,8 @@ Examples:
 		maxFileSizeMB: maxFileSizeMb,
 		ignorePatterns: ignorePattern,
 		webSocketRetryIntervalMs: websocketRetryIntervalMs,
-		logLevel
+		logLevel,
+		health,
+		enableTelemetry
 	};
 }

frontend/local-client-cli/src/cli.ts

@@ -1,5 +1,7 @@
 import * as path from "path";
 import * as fs from "fs/promises";
+import * as fsSync from "fs";
+import type { NetworkConnectionStatus } from "sync-client";
 import {
 	SyncClient,
 	DEFAULT_SETTINGS,
@@ -13,6 +15,19 @@ import { FileWatcher } from "./file-watcher";
 import { formatLogLine, colorize, styleText } from "./logger-formatter";
 import packageJson from "../package.json";
 
+function writeHealthStatus(
+	filePath: string,
+	connectionStatus: NetworkConnectionStatus
+): void {
+	try {
+		fsSync.writeFileSync(filePath, JSON.stringify(connectionStatus));
+	} catch (error) {
+		console.error(
+			`Failed to write health status to ${filePath}: ${error instanceof Error ? error.message : String(error)}`
+		);
+	}
+}
+
 const LOG_LEVEL_ORDER = {
 	[LogLevel.DEBUG]: 0,
 	[LogLevel.INFO]: 1,
@@ -78,11 +93,13 @@ async function main(): Promise<void> {
 		syncConcurrency:
 			args.syncConcurrency ?? DEFAULT_SETTINGS.syncConcurrency,
 		maxFileSizeMB: args.maxFileSizeMB ?? DEFAULT_SETTINGS.maxFileSizeMB,
+		diffCacheSizeMB: DEFAULT_SETTINGS.diffCacheSizeMB,
 		ignorePatterns,
 		webSocketRetryIntervalMs:
 			args.webSocketRetryIntervalMs ??
 			DEFAULT_SETTINGS.webSocketRetryIntervalMs,
-		isSyncEnabled: true
+		isSyncEnabled: true,
+		enableTelemetry: args.enableTelemetry ?? false
 	};
 
 	const client = await SyncClient.create({
@@ -119,6 +136,21 @@ async function main(): Promise<void> {
 		nativeLineEndings: process.platform === "win32" ? "\r\n" : "\n"
 	});
 
+	if (args.health !== undefined) {
+		const healthFile = args.health;
+		const healthInterval = setInterval(() => {
+			void client.checkConnection().then((status) => {
+				writeHealthStatus(healthFile, status);
+			});
+		}, 30 * 1000); // every 30 seconds
+		const clearHealthInterval = (): void => {
+			clearInterval(healthInterval);
+		};
+		process.on("SIGINT", clearHealthInterval);
+		process.on("SIGTERM", clearHealthInterval);
+		process.on("exit", clearHealthInterval);
+	}
+
 	// Add colored log formatter with level filtering
 	client.logger.addOnMessageListener((logLine) => {
 		// Only show messages at or above the configured log level
@@ -132,7 +164,10 @@ async function main(): Promise<void> {
 	const fileWatcher = new FileWatcher(absolutePath, client);
 
 	client.addWebSocketStatusChangeListener(() => {
-		client.logger.info("WebSocket status changed");
+		const isConnected = client.isWebSocketConnected;
+		client.logger.info(
+			`WebSocket status changed: ${isConnected ? "connected" : "disconnected"}`
+		);
 	});
 
 	client.addRemainingSyncOperationsListener((remaining) => {

frontend/local-client-cli/src/healthcheck.ts

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+
+/**
+ * Healthcheck script for Docker container
+ * Checks if the sync client is connected to the server
+ */
+
+import * as fs from "fs";
+import type { NetworkConnectionStatus } from "sync-client";
+
+function isHealthStatus(value: unknown): value is NetworkConnectionStatus {
+	if (typeof value !== "object" || value === null) {
+		return false;
+	}
+
+	return (
+		"isSuccessful" in value &&
+		typeof value.isSuccessful === "boolean" &&
+		"isWebSocketConnected" in value &&
+		typeof value.isWebSocketConnected === "boolean" &&
+		"serverMessage" in value &&
+		typeof value.serverMessage === "string"
+	);
+}
+
+function main(): void {
+	if (process.argv.length < 3) {
+		console.error("Usage: healthcheck <path-to-health-file>");
+		process.exit(1);
+	}
+	const [, , healthFile] = process.argv;
+
+	try {
+		// Check if health file exists
+		if (!fs.existsSync(healthFile)) {
+			console.error(`Health file does not exist: ${healthFile}`);
+			process.exit(1);
+		}
+
+		// Read and parse health status
+		const content = fs.readFileSync(healthFile, "utf-8");
+		const parsed: unknown = JSON.parse(content);
+
+		// Validate the parsed object using type guard
+		if (!isHealthStatus(parsed)) {
+			throw new Error("Invalid health status format");
+		}
+
+		const status = parsed;
+
+		if (!status.isSuccessful || !status.isWebSocketConnected) {
+			console.error("Not connected to server: " + status.serverMessage);
+			process.exit(1);
+		}
+
+		console.log("Healthy: Connected to server");
+		process.exit(0);
+	} catch (error) {
+		console.error(
+			`Health check failed: ${error instanceof Error ? error.message : String(error)}`
+		);
+		process.exit(1);
+	}
+}
+
+main();