@cleocode/core 2026.3.38 → 2026.3.40

package/dist/system/health.d.ts

@@ -1,124 +0,0 @@
-/**
- * System health checks core module.
- * @task T4783
- * @task T4795
- */
-import { type SystemInfo } from '../platform.js';
-export interface HealthCheck {
-    name: string;
-    status: 'pass' | 'warn' | 'fail';
-    message?: string;
-}
-export interface HealthResult {
-    overall: 'healthy' | 'warning' | 'error';
-    checks: HealthCheck[];
-    version: string;
-    installation: 'ok' | 'degraded';
-}
-export interface DiagnosticsCheck {
-    name: string;
-    status: 'pass' | 'warn' | 'fail';
-    details?: string;
-    fix?: string;
-}
-export interface DiagnosticsResult {
-    timestamp: string;
-    checks: DiagnosticsCheck[];
-    summary: {
-        total: number;
-        passed: number;
-        warned: number;
-        failed: number;
-    };
-}
-/** Run system health checks (SQLite-first per ADR-006). */
-export declare function getSystemHealth(projectRoot: string, opts?: {
-    detailed?: boolean;
-}): HealthResult;
-/** Run extended diagnostics with fix suggestions. */
-export declare function getSystemDiagnostics(projectRoot: string, opts?: {
-    checks?: string[];
-}): Promise<DiagnosticsResult>;
-export interface DoctorCheck {
-    check: string;
-    status: 'ok' | 'error' | 'warning';
-    message: string;
-    details?: Record<string, unknown>;
-    fix?: string;
-}
-export interface DoctorReport {
-    healthy: boolean;
-    errors: number;
-    warnings: number;
-    checks: DoctorCheck[];
-}
-/**
- * Run comprehensive doctor diagnostics combining dependency checks,
- * directory checks, data file checks, gitignore checks, and environment info.
- * @task T4795
- */
-export declare function coreDoctorReport(projectRoot: string): Promise<DoctorReport>;
-export interface FixResult {
-    check: string;
-    action: 'fixed' | 'skipped' | 'failed';
-    message: string;
-}
-/**
- * Run auto-fix for failed doctor checks by calling the corresponding ensure* functions.
- * Returns a list of fix results for each attempted repair.
- */
-export declare function runDoctorFixes(projectRoot: string): Promise<FixResult[]>;
-/**
- * Outcome of a startup health check. Tells the caller exactly what state
- * the system is in so it can route to init, upgrade, or proceed normally.
- */
-export type StartupState = 'healthy' | 'needs_init' | 'needs_upgrade';
-export interface StartupHealthCheck {
-    check: string;
-    status: 'pass' | 'warn' | 'fail';
-    message: string;
-    repaired?: boolean;
-}
-export interface StartupHealthResult {
-    /** Overall system state after health check + auto-repair. */
-    state: StartupState;
-    /** True if the global ~/.cleo scaffold is healthy (after auto-repair). */
-    globalHealthy: boolean;
-    /** True if the project .cleo/ scaffold is present and healthy. */
-    projectHealthy: boolean;
-    /** Individual check results for logging/diagnostics. */
-    checks: StartupHealthCheck[];
-    /** Checks that failed and could not be auto-repaired. */
-    failures: StartupHealthCheck[];
-    /** Host system snapshot for diagnostics, error reports, and logging. */
-    system: SystemInfo;
-}
-/**
- * Unified startup health check for MCP server and CLI entry points.
- *
- * This is the single entry point for startup diagnostics. It follows a
- * three-phase approach:
- *
- * Phase 1: Global scaffold (~/.cleo/) — always auto-repaired.
- *   The global home is CLEO infrastructure, not project data. It is safe
- *   to create/repair unconditionally on every startup.
- *
- * Phase 2: Project detection — determines if this is an initialized project.
- *   Uses isProjectInitialized() from paths.ts as the SSoT for detection.
- *
- * Phase 3: Project health — lightweight checks on the project scaffold.
- *   If the project is initialized, runs check* functions to detect drift.
- *   Auto-repairs safe items (missing subdirs via ensureCleoStructure).
- *   Flags items requiring full upgrade (missing DB, config issues).
- *
- * Design principles:
- *   - SSoT: All checks delegate to scaffold.ts check* functions
- *   - DRY: No duplicated health-check logic
- *   - SRP: This function only diagnoses and does safe auto-repair
- *   - Graceful: Never throws. All errors are captured as check results.
- *   - Logged: Returns structured results for the caller to log via pino
- *
- * @param projectRoot - Absolute path to the project root (defaults to cwd)
- */
-export declare function startupHealthCheck(projectRoot?: string): Promise<StartupHealthResult>;
-//# sourceMappingURL=health.d.ts.map

package/dist/system/health.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/system/health.ts"],"names":[],"mappings":"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"}