zouroboros-core 2.0.0

package/dist/config/schema.d.ts

@@ -0,0 +1,597 @@
+/**
+ * Zod validation schemas for Zouroboros configuration
+ *
+ * Provides runtime validation with actionable error messages
+ * for all configuration sections.
+ */
+import { z } from 'zod';
+export declare const CoreConfigSchema: z.ZodObject<{
+    workspaceRoot: z.ZodEffects<z.ZodString, string, string>;
+    dataDir: z.ZodEffects<z.ZodString, string, string>;
+    logLevel: z.ZodEnum<["debug", "info", "warn", "error"]>;
+    defaultTimezone: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    workspaceRoot: string;
+    dataDir: string;
+    logLevel: "debug" | "info" | "warn" | "error";
+    defaultTimezone: string;
+}, {
+    workspaceRoot: string;
+    dataDir: string;
+    logLevel: "debug" | "info" | "warn" | "error";
+    defaultTimezone: string;
+}>;
+export declare const MemoryConfigSchema: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    dbPath: z.ZodEffects<z.ZodString, string, string>;
+    vectorEnabled: z.ZodBoolean;
+    ollamaUrl: z.ZodString;
+    ollamaModel: z.ZodString;
+    autoCapture: z.ZodBoolean;
+    captureIntervalMinutes: z.ZodNumber;
+    graphBoost: z.ZodBoolean;
+    hydeExpansion: z.ZodBoolean;
+    decayConfig: z.ZodObject<{
+        permanent: z.ZodNumber;
+        long: z.ZodNumber;
+        medium: z.ZodNumber;
+        short: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        permanent: number;
+        long: number;
+        medium: number;
+        short: number;
+    }, {
+        permanent: number;
+        long: number;
+        medium: number;
+        short: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    dbPath: string;
+    vectorEnabled: boolean;
+    ollamaUrl: string;
+    ollamaModel: string;
+    autoCapture: boolean;
+    captureIntervalMinutes: number;
+    graphBoost: boolean;
+    hydeExpansion: boolean;
+    decayConfig: {
+        permanent: number;
+        long: number;
+        medium: number;
+        short: number;
+    };
+}, {
+    enabled: boolean;
+    dbPath: string;
+    vectorEnabled: boolean;
+    ollamaUrl: string;
+    ollamaModel: string;
+    autoCapture: boolean;
+    captureIntervalMinutes: number;
+    graphBoost: boolean;
+    hydeExpansion: boolean;
+    decayConfig: {
+        permanent: number;
+        long: number;
+        medium: number;
+        short: number;
+    };
+}>;
+export declare const SwarmConfigSchema: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    defaultCombo: z.ZodString;
+    maxConcurrency: z.ZodNumber;
+    localConcurrency: z.ZodNumber;
+    circuitBreaker: z.ZodObject<{
+        enabled: z.ZodBoolean;
+        failureThreshold: z.ZodNumber;
+        resetTimeoutMs: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        failureThreshold: number;
+        resetTimeoutMs: number;
+    }, {
+        enabled: boolean;
+        failureThreshold: number;
+        resetTimeoutMs: number;
+    }>;
+    retryConfig: z.ZodObject<{
+        maxRetries: z.ZodNumber;
+        backoffMultiplier: z.ZodNumber;
+        maxBackoffMs: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        maxRetries: number;
+        backoffMultiplier: number;
+        maxBackoffMs: number;
+    }, {
+        maxRetries: number;
+        backoffMultiplier: number;
+        maxBackoffMs: number;
+    }>;
+    registryPath: z.ZodEffects<z.ZodString, string, string>;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    defaultCombo: string;
+    maxConcurrency: number;
+    localConcurrency: number;
+    circuitBreaker: {
+        enabled: boolean;
+        failureThreshold: number;
+        resetTimeoutMs: number;
+    };
+    retryConfig: {
+        maxRetries: number;
+        backoffMultiplier: number;
+        maxBackoffMs: number;
+    };
+    registryPath: string;
+}, {
+    enabled: boolean;
+    defaultCombo: string;
+    maxConcurrency: number;
+    localConcurrency: number;
+    circuitBreaker: {
+        enabled: boolean;
+        failureThreshold: number;
+        resetTimeoutMs: number;
+    };
+    retryConfig: {
+        maxRetries: number;
+        backoffMultiplier: number;
+        maxBackoffMs: number;
+    };
+    registryPath: string;
+}>;
+export declare const PersonasConfigSchema: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    identityDir: z.ZodEffects<z.ZodString, string, string>;
+    defaultSoulPath: z.ZodEffects<z.ZodString, string, string>;
+    autoCreateHeartbeat: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    identityDir: string;
+    defaultSoulPath: string;
+    autoCreateHeartbeat: boolean;
+}, {
+    enabled: boolean;
+    identityDir: string;
+    defaultSoulPath: string;
+    autoCreateHeartbeat: boolean;
+}>;
+export declare const SelfHealConfigSchema: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    introspectionInterval: z.ZodString;
+    autoPrescribe: z.ZodBoolean;
+    governorEnabled: z.ZodBoolean;
+    minHealthScore: z.ZodNumber;
+    metrics: z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodEffects<z.ZodObject<{
+        target: z.ZodNumber;
+        weight: z.ZodNumber;
+        warningThreshold: z.ZodNumber;
+        criticalThreshold: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        target: number;
+        weight: number;
+        warningThreshold: number;
+        criticalThreshold: number;
+    }, {
+        target: number;
+        weight: number;
+        warningThreshold: number;
+        criticalThreshold: number;
+    }>, {
+        target: number;
+        weight: number;
+        warningThreshold: number;
+        criticalThreshold: number;
+    }, {
+        target: number;
+        weight: number;
+        warningThreshold: number;
+        criticalThreshold: number;
+    }>, {
+        target: number;
+        weight: number;
+        warningThreshold: number;
+        criticalThreshold: number;
+    }, {
+        target: number;
+        weight: number;
+        warningThreshold: number;
+        criticalThreshold: number;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    introspectionInterval: string;
+    autoPrescribe: boolean;
+    governorEnabled: boolean;
+    minHealthScore: number;
+    metrics: Record<string, {
+        target: number;
+        weight: number;
+        warningThreshold: number;
+        criticalThreshold: number;
+    }>;
+}, {
+    enabled: boolean;
+    introspectionInterval: string;
+    autoPrescribe: boolean;
+    governorEnabled: boolean;
+    minHealthScore: number;
+    metrics: Record<string, {
+        target: number;
+        weight: number;
+        warningThreshold: number;
+        criticalThreshold: number;
+    }>;
+}>;
+export declare const ZouroborosConfigSchema: z.ZodObject<{
+    version: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    core: z.ZodObject<{
+        workspaceRoot: z.ZodEffects<z.ZodString, string, string>;
+        dataDir: z.ZodEffects<z.ZodString, string, string>;
+        logLevel: z.ZodEnum<["debug", "info", "warn", "error"]>;
+        defaultTimezone: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        workspaceRoot: string;
+        dataDir: string;
+        logLevel: "debug" | "info" | "warn" | "error";
+        defaultTimezone: string;
+    }, {
+        workspaceRoot: string;
+        dataDir: string;
+        logLevel: "debug" | "info" | "warn" | "error";
+        defaultTimezone: string;
+    }>;
+    memory: z.ZodObject<{
+        enabled: z.ZodBoolean;
+        dbPath: z.ZodEffects<z.ZodString, string, string>;
+        vectorEnabled: z.ZodBoolean;
+        ollamaUrl: z.ZodString;
+        ollamaModel: z.ZodString;
+        autoCapture: z.ZodBoolean;
+        captureIntervalMinutes: z.ZodNumber;
+        graphBoost: z.ZodBoolean;
+        hydeExpansion: z.ZodBoolean;
+        decayConfig: z.ZodObject<{
+            permanent: z.ZodNumber;
+            long: z.ZodNumber;
+            medium: z.ZodNumber;
+            short: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            permanent: number;
+            long: number;
+            medium: number;
+            short: number;
+        }, {
+            permanent: number;
+            long: number;
+            medium: number;
+            short: number;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        dbPath: string;
+        vectorEnabled: boolean;
+        ollamaUrl: string;
+        ollamaModel: string;
+        autoCapture: boolean;
+        captureIntervalMinutes: number;
+        graphBoost: boolean;
+        hydeExpansion: boolean;
+        decayConfig: {
+            permanent: number;
+            long: number;
+            medium: number;
+            short: number;
+        };
+    }, {
+        enabled: boolean;
+        dbPath: string;
+        vectorEnabled: boolean;
+        ollamaUrl: string;
+        ollamaModel: string;
+        autoCapture: boolean;
+        captureIntervalMinutes: number;
+        graphBoost: boolean;
+        hydeExpansion: boolean;
+        decayConfig: {
+            permanent: number;
+            long: number;
+            medium: number;
+            short: number;
+        };
+    }>;
+    swarm: z.ZodObject<{
+        enabled: z.ZodBoolean;
+        defaultCombo: z.ZodString;
+        maxConcurrency: z.ZodNumber;
+        localConcurrency: z.ZodNumber;
+        circuitBreaker: z.ZodObject<{
+            enabled: z.ZodBoolean;
+            failureThreshold: z.ZodNumber;
+            resetTimeoutMs: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            enabled: boolean;
+            failureThreshold: number;
+            resetTimeoutMs: number;
+        }, {
+            enabled: boolean;
+            failureThreshold: number;
+            resetTimeoutMs: number;
+        }>;
+        retryConfig: z.ZodObject<{
+            maxRetries: z.ZodNumber;
+            backoffMultiplier: z.ZodNumber;
+            maxBackoffMs: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            maxRetries: number;
+            backoffMultiplier: number;
+            maxBackoffMs: number;
+        }, {
+            maxRetries: number;
+            backoffMultiplier: number;
+            maxBackoffMs: number;
+        }>;
+        registryPath: z.ZodEffects<z.ZodString, string, string>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        defaultCombo: string;
+        maxConcurrency: number;
+        localConcurrency: number;
+        circuitBreaker: {
+            enabled: boolean;
+            failureThreshold: number;
+            resetTimeoutMs: number;
+        };
+        retryConfig: {
+            maxRetries: number;
+            backoffMultiplier: number;
+            maxBackoffMs: number;
+        };
+        registryPath: string;
+    }, {
+        enabled: boolean;
+        defaultCombo: string;
+        maxConcurrency: number;
+        localConcurrency: number;
+        circuitBreaker: {
+            enabled: boolean;
+            failureThreshold: number;
+            resetTimeoutMs: number;
+        };
+        retryConfig: {
+            maxRetries: number;
+            backoffMultiplier: number;
+            maxBackoffMs: number;
+        };
+        registryPath: string;
+    }>;
+    personas: z.ZodObject<{
+        enabled: z.ZodBoolean;
+        identityDir: z.ZodEffects<z.ZodString, string, string>;
+        defaultSoulPath: z.ZodEffects<z.ZodString, string, string>;
+        autoCreateHeartbeat: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        identityDir: string;
+        defaultSoulPath: string;
+        autoCreateHeartbeat: boolean;
+    }, {
+        enabled: boolean;
+        identityDir: string;
+        defaultSoulPath: string;
+        autoCreateHeartbeat: boolean;
+    }>;
+    selfheal: z.ZodObject<{
+        enabled: z.ZodBoolean;
+        introspectionInterval: z.ZodString;
+        autoPrescribe: z.ZodBoolean;
+        governorEnabled: z.ZodBoolean;
+        minHealthScore: z.ZodNumber;
+        metrics: z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodEffects<z.ZodObject<{
+            target: z.ZodNumber;
+            weight: z.ZodNumber;
+            warningThreshold: z.ZodNumber;
+            criticalThreshold: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            target: number;
+            weight: number;
+            warningThreshold: number;
+            criticalThreshold: number;
+        }, {
+            target: number;
+            weight: number;
+            warningThreshold: number;
+            criticalThreshold: number;
+        }>, {
+            target: number;
+            weight: number;
+            warningThreshold: number;
+            criticalThreshold: number;
+        }, {
+            target: number;
+            weight: number;
+            warningThreshold: number;
+            criticalThreshold: number;
+        }>, {
+            target: number;
+            weight: number;
+            warningThreshold: number;
+            criticalThreshold: number;
+        }, {
+            target: number;
+            weight: number;
+            warningThreshold: number;
+            criticalThreshold: number;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        introspectionInterval: string;
+        autoPrescribe: boolean;
+        governorEnabled: boolean;
+        minHealthScore: number;
+        metrics: Record<string, {
+            target: number;
+            weight: number;
+            warningThreshold: number;
+            criticalThreshold: number;
+        }>;
+    }, {
+        enabled: boolean;
+        introspectionInterval: string;
+        autoPrescribe: boolean;
+        governorEnabled: boolean;
+        minHealthScore: number;
+        metrics: Record<string, {
+            target: number;
+            weight: number;
+            warningThreshold: number;
+            criticalThreshold: number;
+        }>;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    memory: {
+        enabled: boolean;
+        dbPath: string;
+        vectorEnabled: boolean;
+        ollamaUrl: string;
+        ollamaModel: string;
+        autoCapture: boolean;
+        captureIntervalMinutes: number;
+        graphBoost: boolean;
+        hydeExpansion: boolean;
+        decayConfig: {
+            permanent: number;
+            long: number;
+            medium: number;
+            short: number;
+        };
+    };
+    swarm: {
+        enabled: boolean;
+        defaultCombo: string;
+        maxConcurrency: number;
+        localConcurrency: number;
+        circuitBreaker: {
+            enabled: boolean;
+            failureThreshold: number;
+            resetTimeoutMs: number;
+        };
+        retryConfig: {
+            maxRetries: number;
+            backoffMultiplier: number;
+            maxBackoffMs: number;
+        };
+        registryPath: string;
+    };
+    selfheal: {
+        enabled: boolean;
+        introspectionInterval: string;
+        autoPrescribe: boolean;
+        governorEnabled: boolean;
+        minHealthScore: number;
+        metrics: Record<string, {
+            target: number;
+            weight: number;
+            warningThreshold: number;
+            criticalThreshold: number;
+        }>;
+    };
+    version: string;
+    createdAt: string;
+    updatedAt: string;
+    core: {
+        workspaceRoot: string;
+        dataDir: string;
+        logLevel: "debug" | "info" | "warn" | "error";
+        defaultTimezone: string;
+    };
+    personas: {
+        enabled: boolean;
+        identityDir: string;
+        defaultSoulPath: string;
+        autoCreateHeartbeat: boolean;
+    };
+}, {
+    memory: {
+        enabled: boolean;
+        dbPath: string;
+        vectorEnabled: boolean;
+        ollamaUrl: string;
+        ollamaModel: string;
+        autoCapture: boolean;
+        captureIntervalMinutes: number;
+        graphBoost: boolean;
+        hydeExpansion: boolean;
+        decayConfig: {
+            permanent: number;
+            long: number;
+            medium: number;
+            short: number;
+        };
+    };
+    swarm: {
+        enabled: boolean;
+        defaultCombo: string;
+        maxConcurrency: number;
+        localConcurrency: number;
+        circuitBreaker: {
+            enabled: boolean;
+            failureThreshold: number;
+            resetTimeoutMs: number;
+        };
+        retryConfig: {
+            maxRetries: number;
+            backoffMultiplier: number;
+            maxBackoffMs: number;
+        };
+        registryPath: string;
+    };
+    selfheal: {
+        enabled: boolean;
+        introspectionInterval: string;
+        autoPrescribe: boolean;
+        governorEnabled: boolean;
+        minHealthScore: number;
+        metrics: Record<string, {
+            target: number;
+            weight: number;
+            warningThreshold: number;
+            criticalThreshold: number;
+        }>;
+    };
+    version: string;
+    createdAt: string;
+    updatedAt: string;
+    core: {
+        workspaceRoot: string;
+        dataDir: string;
+        logLevel: "debug" | "info" | "warn" | "error";
+        defaultTimezone: string;
+    };
+    personas: {
+        enabled: boolean;
+        identityDir: string;
+        defaultSoulPath: string;
+        autoCreateHeartbeat: boolean;
+    };
+}>;
+export type ConfigValidationIssue = {
+    path: string;
+    message: string;
+};
+/**
+ * Validate a config object and return structured errors.
+ * Returns null if valid, or an array of issues with paths.
+ */
+export declare function validateConfigSchema(config: unknown): ConfigValidationIssue[] | null;
+/**
+ * Format validation issues into a human-readable string.
+ */
+export declare function formatValidationErrors(issues: ConfigValidationIssue[]): string;