feat: add integration test framework and health check improvements
- Add test helper library with assertion functions (scripts/lib/test-helpers.sh) - Add gateway integration test script (scripts/tests/gateway-test.sh) - Add configuration validation tool (scripts/validate-config.ts) - Add health-check.ts library with Tauri command wrappers - Add HealthStatusIndicator component to ConnectionStatus.tsx - Add E2E test specs for memory, settings, and team collaboration - Update ZCLAW-DEEP-ANALYSIS.md to reflect actual project state Key improvements: - Store architecture now properly documented as migrated - Tauri backend shown as 85-90% complete - Component integration status clarified Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
137
desktop/src/lib/health-check.ts
Normal file
137
desktop/src/lib/health-check.ts
Normal file
@@ -0,0 +1,137 @@
|
||||
/**
|
||||
* Health Check Library
|
||||
*
|
||||
* Provides Tauri health check command wrappers and utilities
|
||||
* for monitoring the health status of the OpenFang backend.
|
||||
*/
|
||||
|
||||
import { invoke } from '@tauri-apps/api/core';
|
||||
import { isTauriRuntime } from './tauri-gateway';
|
||||
|
||||
// === Types ===
|
||||
|
||||
export type HealthStatus = 'healthy' | 'unhealthy' | 'unknown';
|
||||
|
||||
export interface HealthCheckResult {
|
||||
status: HealthStatus;
|
||||
message?: string;
|
||||
timestamp: number;
|
||||
details?: Record<string, unknown>;
|
||||
}
|
||||
|
||||
export interface OpenFangHealthResponse {
|
||||
healthy: boolean;
|
||||
message?: string;
|
||||
details?: Record<string, unknown>;
|
||||
}
|
||||
|
||||
// === Health Check Functions ===
|
||||
|
||||
/**
|
||||
* Perform a single health check via Tauri command.
|
||||
* Returns a structured result with status, message, and timestamp.
|
||||
*/
|
||||
export async function performHealthCheck(): Promise<HealthCheckResult> {
|
||||
const timestamp = Date.now();
|
||||
|
||||
if (!isTauriRuntime()) {
|
||||
return {
|
||||
status: 'unknown',
|
||||
message: 'Not running in Tauri environment',
|
||||
timestamp,
|
||||
};
|
||||
}
|
||||
|
||||
try {
|
||||
const response = await invoke<OpenFangHealthResponse>('openfang_health_check');
|
||||
|
||||
return {
|
||||
status: response.healthy ? 'healthy' : 'unhealthy',
|
||||
message: response.message,
|
||||
timestamp,
|
||||
details: response.details,
|
||||
};
|
||||
} catch (error) {
|
||||
const errorMessage = error instanceof Error ? error.message : String(error);
|
||||
return {
|
||||
status: 'unhealthy',
|
||||
message: `Health check failed: ${errorMessage}`,
|
||||
timestamp,
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a periodic health check scheduler.
|
||||
* Returns cleanup function to stop the interval.
|
||||
*/
|
||||
export function createHealthCheckScheduler(
|
||||
callback: (result: HealthCheckResult) => void,
|
||||
intervalMs: number = 30000 // Default: 30 seconds
|
||||
): () => void {
|
||||
let intervalId: ReturnType<typeof setInterval> | null = null;
|
||||
let isChecking = false;
|
||||
|
||||
const check = async () => {
|
||||
// Prevent overlapping checks
|
||||
if (isChecking) return;
|
||||
isChecking = true;
|
||||
|
||||
try {
|
||||
const result = await performHealthCheck();
|
||||
callback(result);
|
||||
} catch (error) {
|
||||
console.error('[HealthCheck] Scheduled check failed:', error);
|
||||
callback({
|
||||
status: 'unknown',
|
||||
message: error instanceof Error ? error.message : 'Unknown error',
|
||||
timestamp: Date.now(),
|
||||
});
|
||||
} finally {
|
||||
isChecking = false;
|
||||
}
|
||||
};
|
||||
|
||||
// Perform initial check immediately
|
||||
check();
|
||||
|
||||
// Schedule periodic checks
|
||||
intervalId = setInterval(check, intervalMs);
|
||||
|
||||
// Return cleanup function
|
||||
return () => {
|
||||
if (intervalId !== null) {
|
||||
clearInterval(intervalId);
|
||||
intervalId = null;
|
||||
}
|
||||
};
|
||||
}
|
||||
|
||||
// === Utility Functions ===
|
||||
|
||||
/**
|
||||
* Get a human-readable label for a health status.
|
||||
*/
|
||||
export function getHealthStatusLabel(status: HealthStatus): string {
|
||||
switch (status) {
|
||||
case 'healthy':
|
||||
return '健康';
|
||||
case 'unhealthy':
|
||||
return '异常';
|
||||
case 'unknown':
|
||||
default:
|
||||
return '未知';
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Format a timestamp for display.
|
||||
*/
|
||||
export function formatHealthCheckTime(timestamp: number): string {
|
||||
const date = new Date(timestamp);
|
||||
return date.toLocaleTimeString('zh-CN', {
|
||||
hour: '2-digit',
|
||||
minute: '2-digit',
|
||||
second: '2-digit',
|
||||
});
|
||||
}
|
||||
Reference in New Issue
Block a user