zouroboros-core 2.0.0

package/dist/config/schema.js

@@ -0,0 +1,151 @@
+/**
+ * Zod validation schemas for Zouroboros configuration
+ *
+ * Provides runtime validation with actionable error messages
+ * for all configuration sections.
+ */
+import { z } from 'zod';
+// ============================================================================
+// Primitive Schemas
+// ============================================================================
+const cronExpression = z
+    .string()
+    .regex(/^[\d*,/-]+ [\d*,/-]+ [\d*,/-]+ [\d*,/-]+ [\d*,/-]+$/, {
+    message: 'Must be a valid 5-field cron expression (e.g., "0 5 * * *")',
+});
+const absolutePath = z
+    .string()
+    .min(1, 'Path must not be empty')
+    .refine((p) => p.startsWith('/') || p.startsWith('~'), {
+    message: 'Path must be absolute (start with / or ~)',
+});
+const urlString = z
+    .string()
+    .url('Must be a valid URL (e.g., "http://localhost:11434")');
+const positiveInt = z
+    .number()
+    .int('Must be a whole number')
+    .positive('Must be greater than 0');
+const positiveNumber = z
+    .number()
+    .positive('Must be greater than 0');
+const unitInterval = z
+    .number()
+    .min(0, 'Must be between 0 and 1')
+    .max(1, 'Must be between 0 and 1');
+// ============================================================================
+// Section Schemas
+// ============================================================================
+export const CoreConfigSchema = z.object({
+    workspaceRoot: absolutePath,
+    dataDir: absolutePath,
+    logLevel: z.enum(['debug', 'info', 'warn', 'error'], {
+        errorMap: () => ({ message: 'logLevel must be one of: debug, info, warn, error' }),
+    }),
+    defaultTimezone: z
+        .string()
+        .min(1, 'Timezone must not be empty (e.g., "America/Phoenix", "UTC")'),
+});
+export const MemoryConfigSchema = z.object({
+    enabled: z.boolean(),
+    dbPath: absolutePath,
+    vectorEnabled: z.boolean(),
+    ollamaUrl: urlString,
+    ollamaModel: z.string().min(1, 'Ollama model name must not be empty'),
+    autoCapture: z.boolean(),
+    captureIntervalMinutes: positiveInt.describe('Interval in minutes between auto-captures'),
+    graphBoost: z.boolean(),
+    hydeExpansion: z.boolean(),
+    decayConfig: z.object({
+        permanent: positiveNumber,
+        long: positiveNumber,
+        medium: positiveNumber,
+        short: positiveNumber,
+    }),
+});
+const CircuitBreakerSchema = z.object({
+    enabled: z.boolean(),
+    failureThreshold: positiveInt.describe('Number of failures before circuit opens'),
+    resetTimeoutMs: positiveInt.describe('Milliseconds before circuit resets'),
+});
+const RetryConfigSchema = z.object({
+    maxRetries: z.number().int().min(0, 'maxRetries must be 0 or greater'),
+    backoffMultiplier: positiveNumber,
+    maxBackoffMs: positiveInt,
+});
+export const SwarmConfigSchema = z.object({
+    enabled: z.boolean(),
+    defaultCombo: z.string().min(1, 'Default combo must not be empty'),
+    maxConcurrency: positiveInt.describe('Max parallel tasks across all executors'),
+    localConcurrency: positiveInt.describe('Max parallel tasks on local machine'),
+    circuitBreaker: CircuitBreakerSchema,
+    retryConfig: RetryConfigSchema,
+    registryPath: absolutePath,
+});
+export const PersonasConfigSchema = z.object({
+    enabled: z.boolean(),
+    identityDir: absolutePath,
+    defaultSoulPath: absolutePath,
+    autoCreateHeartbeat: z.boolean(),
+});
+const MetricThresholdSchema = z
+    .object({
+    target: unitInterval,
+    weight: unitInterval,
+    warningThreshold: unitInterval,
+    criticalThreshold: unitInterval,
+})
+    .refine((m) => m.criticalThreshold <= m.warningThreshold, {
+    message: 'criticalThreshold must be ≤ warningThreshold',
+})
+    .refine((m) => m.warningThreshold <= m.target, {
+    message: 'warningThreshold must be ≤ target',
+});
+export const SelfHealConfigSchema = z.object({
+    enabled: z.boolean(),
+    introspectionInterval: cronExpression,
+    autoPrescribe: z.boolean(),
+    governorEnabled: z.boolean(),
+    minHealthScore: z.number().min(0).max(100, 'minHealthScore must be 0-100'),
+    metrics: z.record(z.string(), MetricThresholdSchema),
+});
+// ============================================================================
+// Root Schema
+// ============================================================================
+export const ZouroborosConfigSchema = z.object({
+    version: z.string().min(1),
+    createdAt: z.string().min(1, 'createdAt timestamp is required'),
+    updatedAt: z.string().min(1, 'updatedAt timestamp is required'),
+    core: CoreConfigSchema,
+    memory: MemoryConfigSchema,
+    swarm: SwarmConfigSchema,
+    personas: PersonasConfigSchema,
+    selfheal: SelfHealConfigSchema,
+});
+/**
+ * Validate a config object and return structured errors.
+ * Returns null if valid, or an array of issues with paths.
+ */
+export function validateConfigSchema(config) {
+    const result = ZouroborosConfigSchema.safeParse(config);
+    if (result.success)
+        return null;
+    return result.error.issues.map((issue) => ({
+        path: issue.path.join('.'),
+        message: issue.message,
+    }));
+}
+/**
+ * Format validation issues into a human-readable string.
+ */
+export function formatValidationErrors(issues) {
+    const lines = ['Configuration validation failed:', ''];
+    for (const issue of issues) {
+        const location = issue.path ? `  ${issue.path}` : '  (root)';
+        lines.push(`${location}: ${issue.message}`);
+    }
+    lines.push('');
+    lines.push('Run "zouroboros config list" to see current values.');
+    lines.push('Run "zouroboros config set <key> <value>" to fix.');
+    return lines.join('\n');
+}

package/dist/constants.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Core constants for Zouroboros
+ */
+import type { ZouroborosConfig, MetricThreshold } from './types.js';
+export declare const ZOUROBOROS_VERSION = "2.0.0";
+export declare const ZOUROBOROS_NAME = "Zouroboros";
+export declare const DEFAULT_WORKSPACE_ROOT = "/home/workspace";
+export declare const DEFAULT_DATA_DIR: string;
+export declare const DEFAULT_CONFIG_DIR: string;
+export declare const DEFAULT_CONFIG_PATH: string;
+export declare const DEFAULT_MEMORY_DB_PATH: string;
+export declare const DEFAULT_OLLAMA_URL = "http://localhost:11434";
+export declare const DEFAULT_OLLAMA_MODEL = "nomic-embed-text";
+export declare const DEFAULT_CAPTURE_INTERVAL = 30;
+export declare const DECAY_DAYS: {
+    permanent: number;
+    long: number;
+    medium: number;
+    short: number;
+};
+export declare const DEFAULT_SWARM_COMBO = "swarm-mid";
+export declare const DEFAULT_MAX_CONCURRENCY = 5;
+export declare const DEFAULT_LOCAL_CONCURRENCY = 2;
+export declare const CIRCUIT_BREAKER_DEFAULTS: {
+    enabled: boolean;
+    failureThreshold: number;
+    resetTimeoutMs: number;
+};
+export declare const RETRY_DEFAULTS: {
+    maxRetries: number;
+    backoffMultiplier: number;
+    maxBackoffMs: number;
+};
+export declare const DEFAULT_LATENCY_PREFERENCE = "balanced";
+export declare const COMPLEXITY_THRESHOLDS: {
+    trivial: number;
+    simple: number;
+    moderate: number;
+    complex: number;
+};
+export declare const STATIC_COMBO_MAP: Record<string, string>;
+export declare const DEFAULT_INTROSPECTION_CRON = "0 5 * * *";
+export declare const DEFAULT_MIN_HEALTH_SCORE = 70;
+export declare const DEFAULT_METRIC_THRESHOLDS: Record<string, MetricThreshold>;
+export declare const DEFAULT_CONFIG: ZouroborosConfig;
+export declare const VALID_LOG_LEVELS: readonly ["debug", "info", "warn", "error"];
+export declare const VALID_LATENCY_PREFERENCES: readonly ["fast", "balanced", "quality"];
+export declare const VALID_DECAY_CLASSES: readonly ["permanent", "long", "medium", "short"];
+export declare const VALID_TASK_TYPES: readonly ["coding", "review", "planning", "analysis", "debugging", "documentation", "general"];
+export declare const IGNORE_PATTERNS: string[];
+export declare const MEMORY_FILE_EXTENSIONS: string[];
+export declare const CLI_COMMANDS: readonly ["init", "doctor", "config", "memory", "swarm", "persona", "workflow", "selfheal"];
+export declare const MEMORY_SUBCOMMANDS: readonly ["store", "search", "hybrid", "graph", "capture", "stats"];
+export declare const SWARM_SUBCOMMANDS: readonly ["run", "status", "registry", "bridges"];
+export declare const PERSONA_SUBCOMMANDS: readonly ["create", "list", "activate", "deactivate"];
+export declare const WORKFLOW_SUBCOMMANDS: readonly ["interview", "evaluate", "unstuck"];
+export declare const SELFHEAL_SUBCOMMANDS: readonly ["introspect", "prescribe", "evolve"];

package/dist/constants.js

@@ -0,0 +1,225 @@
+/**
+ * Core constants for Zouroboros
+ */
+import { join } from 'path';
+import { homedir } from 'os';
+export const ZOUROBOROS_VERSION = '2.0.0';
+export const ZOUROBOROS_NAME = 'Zouroboros';
+// ============================================================================
+// Paths
+// ============================================================================
+export const DEFAULT_WORKSPACE_ROOT = '/home/workspace';
+export const DEFAULT_DATA_DIR = join(homedir(), '.zouroboros');
+export const DEFAULT_CONFIG_DIR = DEFAULT_DATA_DIR;
+export const DEFAULT_CONFIG_PATH = join(DEFAULT_CONFIG_DIR, 'config.json');
+// ============================================================================
+// Memory System Defaults
+// ============================================================================
+export const DEFAULT_MEMORY_DB_PATH = join(DEFAULT_DATA_DIR, 'memory.db');
+export const DEFAULT_OLLAMA_URL = 'http://localhost:11434';
+export const DEFAULT_OLLAMA_MODEL = 'nomic-embed-text';
+export const DEFAULT_CAPTURE_INTERVAL = 30; // minutes
+export const DECAY_DAYS = {
+    permanent: Infinity,
+    long: 365,
+    medium: 90,
+    short: 30,
+};
+// ============================================================================
+// Swarm Defaults
+// ============================================================================
+export const DEFAULT_SWARM_COMBO = 'swarm-mid';
+export const DEFAULT_MAX_CONCURRENCY = 5;
+export const DEFAULT_LOCAL_CONCURRENCY = 2;
+export const CIRCUIT_BREAKER_DEFAULTS = {
+    enabled: true,
+    failureThreshold: 5,
+    resetTimeoutMs: 30000,
+};
+export const RETRY_DEFAULTS = {
+    maxRetries: 3,
+    backoffMultiplier: 2,
+    maxBackoffMs: 30000,
+};
+// ============================================================================
+// Routing Service Defaults
+// ============================================================================
+export const DEFAULT_LATENCY_PREFERENCE = 'balanced';
+// Complexity score thresholds
+export const COMPLEXITY_THRESHOLDS = {
+    trivial: 0.3,
+    simple: 0.5,
+    moderate: 0.7,
+    complex: 1.0,
+};
+// Static combo mapping (fallback when external combo service is unavailable)
+export const STATIC_COMBO_MAP = {
+    trivial: 'swarm-light',
+    simple: 'swarm-light',
+    moderate: 'swarm-mid',
+    complex: 'swarm-heavy',
+};
+// ============================================================================
+// Self-Heal Defaults
+// ============================================================================
+export const DEFAULT_INTROSPECTION_CRON = '0 5 * * *'; // 5 AM daily
+export const DEFAULT_MIN_HEALTH_SCORE = 70;
+export const DEFAULT_METRIC_THRESHOLDS = {
+    memoryRecall: {
+        target: 0.85,
+        weight: 0.25,
+        warningThreshold: 0.75,
+        criticalThreshold: 0.60,
+    },
+    graphConnectivity: {
+        target: 0.80,
+        weight: 0.15,
+        warningThreshold: 0.70,
+        criticalThreshold: 0.55,
+    },
+    routingAccuracy: {
+        target: 0.85,
+        weight: 0.20,
+        warningThreshold: 0.75,
+        criticalThreshold: 0.60,
+    },
+    evalCalibration: {
+        target: 0.85,
+        weight: 0.15,
+        warningThreshold: 0.75,
+        criticalThreshold: 0.60,
+    },
+    procedureFreshness: {
+        target: 0.70,
+        weight: 0.15,
+        warningThreshold: 0.60,
+        criticalThreshold: 0.45,
+    },
+    episodeVelocity: {
+        target: 0.60,
+        weight: 0.10,
+        warningThreshold: 0.50,
+        criticalThreshold: 0.35,
+    },
+};
+// ============================================================================
+// Default Configuration Object
+// ============================================================================
+export const DEFAULT_CONFIG = {
+    version: ZOUROBOROS_VERSION,
+    createdAt: new Date().toISOString(),
+    updatedAt: new Date().toISOString(),
+    core: {
+        workspaceRoot: DEFAULT_WORKSPACE_ROOT,
+        dataDir: DEFAULT_DATA_DIR,
+        logLevel: 'info',
+        defaultTimezone: 'America/Phoenix',
+    },
+    memory: {
+        enabled: true,
+        dbPath: DEFAULT_MEMORY_DB_PATH,
+        vectorEnabled: true,
+        ollamaUrl: DEFAULT_OLLAMA_URL,
+        ollamaModel: DEFAULT_OLLAMA_MODEL,
+        autoCapture: true,
+        captureIntervalMinutes: DEFAULT_CAPTURE_INTERVAL,
+        graphBoost: true,
+        hydeExpansion: true,
+        decayConfig: DECAY_DAYS,
+    },
+    swarm: {
+        enabled: true,
+        defaultCombo: DEFAULT_SWARM_COMBO,
+        maxConcurrency: DEFAULT_MAX_CONCURRENCY,
+        localConcurrency: DEFAULT_LOCAL_CONCURRENCY,
+        circuitBreaker: CIRCUIT_BREAKER_DEFAULTS,
+        retryConfig: RETRY_DEFAULTS,
+        registryPath: join(DEFAULT_DATA_DIR, 'executor-registry.json'),
+    },
+    personas: {
+        enabled: true,
+        identityDir: join(DEFAULT_WORKSPACE_ROOT, 'IDENTITY'),
+        defaultSoulPath: join(DEFAULT_WORKSPACE_ROOT, 'SOUL.md'),
+        autoCreateHeartbeat: false,
+    },
+    selfheal: {
+        enabled: true,
+        introspectionInterval: DEFAULT_INTROSPECTION_CRON,
+        autoPrescribe: false,
+        governorEnabled: true,
+        minHealthScore: DEFAULT_MIN_HEALTH_SCORE,
+        metrics: DEFAULT_METRIC_THRESHOLDS,
+    },
+};
+// ============================================================================
+// Validation Constants
+// ============================================================================
+export const VALID_LOG_LEVELS = ['debug', 'info', 'warn', 'error'];
+export const VALID_LATENCY_PREFERENCES = ['fast', 'balanced', 'quality'];
+export const VALID_DECAY_CLASSES = ['permanent', 'long', 'medium', 'short'];
+export const VALID_TASK_TYPES = [
+    'coding',
+    'review',
+    'planning',
+    'analysis',
+    'debugging',
+    'documentation',
+    'general',
+];
+// ============================================================================
+// File Patterns
+// ============================================================================
+export const IGNORE_PATTERNS = [
+    'node_modules/**',
+    '.git/**',
+    'dist/**',
+    'build/**',
+    '.zouroboros/**',
+    '*.log',
+    '*.tmp',
+    '.env*',
+];
+export const MEMORY_FILE_EXTENSIONS = ['.md', '.txt', '.ts', '.js', '.json', '.yaml', '.yml'];
+// ============================================================================
+// CLI Constants
+// ============================================================================
+export const CLI_COMMANDS = [
+    'init',
+    'doctor',
+    'config',
+    'memory',
+    'swarm',
+    'persona',
+    'workflow',
+    'selfheal',
+];
+export const MEMORY_SUBCOMMANDS = [
+    'store',
+    'search',
+    'hybrid',
+    'graph',
+    'capture',
+    'stats',
+];
+export const SWARM_SUBCOMMANDS = [
+    'run',
+    'status',
+    'registry',
+    'bridges',
+];
+export const PERSONA_SUBCOMMANDS = [
+    'create',
+    'list',
+    'activate',
+    'deactivate',
+];
+export const WORKFLOW_SUBCOMMANDS = [
+    'interview',
+    'evaluate',
+    'unstuck',
+];
+export const SELFHEAL_SUBCOMMANDS = [
+    'introspect',
+    'prescribe',
+    'evolve',
+];

package/dist/errors.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Error recovery and graceful degradation for Zouroboros subsystems.
+ *
+ * Tracks subsystem health, provides circuit-breaker behavior,
+ * and enables fallback paths when dependencies are unavailable.
+ */
+export type SubsystemName = 'memory' | 'ollama' | 'swarm' | 'selfheal';
+export type SubsystemStatus = 'healthy' | 'degraded' | 'unavailable';
+export interface SubsystemHealth {
+    name: SubsystemName;
+    status: SubsystemStatus;
+    lastCheck: string;
+    lastError?: string;
+    consecutiveFailures: number;
+    totalFailures: number;
+    totalSuccesses: number;
+    circuitOpen: boolean;
+    circuitOpensAt: number;
+    circuitResetMs: number;
+    circuitOpenedAt?: number;
+}
+export interface RecoveryReport {
+    timestamp: string;
+    subsystems: SubsystemHealth[];
+    overallStatus: SubsystemStatus;
+    degradedCapabilities: string[];
+}
+/**
+ * Record a successful operation for a subsystem.
+ */
+export declare function recordSuccess(name: SubsystemName): void;
+/**
+ * Record a failed operation for a subsystem.
+ */
+export declare function recordFailure(name: SubsystemName, error: string): void;
+/**
+ * Check if a subsystem's circuit breaker allows a call.
+ * Returns true if the call should proceed, false if circuit is open.
+ * Implements half-open: after resetMs, allows one probe call.
+ */
+export declare function isAvailable(name: SubsystemName): boolean;
+/**
+ * Get the current health of a subsystem.
+ */
+export declare function getHealth(name: SubsystemName): SubsystemHealth;
+/**
+ * Get a full recovery report across all tracked subsystems.
+ */
+export declare function getRecoveryReport(): RecoveryReport;
+/**
+ * Reset a subsystem's health tracking (e.g., after manual recovery).
+ */
+export declare function resetHealth(name: SubsystemName): void;
+/**
+ * Reset all subsystem health tracking.
+ */
+export declare function resetAllHealth(): void;
+/**
+ * Configure circuit breaker thresholds for a subsystem.
+ */
+export declare function configureCircuitBreaker(name: SubsystemName, options: {
+    opensAt?: number;
+    resetMs?: number;
+}): void;
+/**
+ * Wrap an async operation with error recovery.
+ * Records success/failure and returns fallback value when circuit is open.
+ */
+export declare function withRecovery<T>(name: SubsystemName, operation: () => Promise<T>, fallback: T): Promise<{
+    value: T;
+    degraded: boolean;
+}>;
+/**
+ * Wrap a synchronous operation with error recovery.
+ */
+export declare function withRecoverySync<T>(name: SubsystemName, operation: () => T, fallback: T): {
+    value: T;
+    degraded: boolean;
+};

package/dist/errors.js

@@ -0,0 +1,171 @@
+/**
+ * Error recovery and graceful degradation for Zouroboros subsystems.
+ *
+ * Tracks subsystem health, provides circuit-breaker behavior,
+ * and enables fallback paths when dependencies are unavailable.
+ */
+const DEFAULT_CIRCUIT_OPENS_AT = 5;
+const DEFAULT_CIRCUIT_RESET_MS = 30_000;
+const subsystems = new Map();
+function getOrCreate(name) {
+    if (!subsystems.has(name)) {
+        subsystems.set(name, {
+            name,
+            status: 'healthy',
+            lastCheck: new Date().toISOString(),
+            consecutiveFailures: 0,
+            totalFailures: 0,
+            totalSuccesses: 0,
+            circuitOpen: false,
+            circuitOpensAt: DEFAULT_CIRCUIT_OPENS_AT,
+            circuitResetMs: DEFAULT_CIRCUIT_RESET_MS,
+        });
+    }
+    return subsystems.get(name);
+}
+/**
+ * Record a successful operation for a subsystem.
+ */
+export function recordSuccess(name) {
+    const health = getOrCreate(name);
+    health.consecutiveFailures = 0;
+    health.totalSuccesses++;
+    health.status = 'healthy';
+    health.lastCheck = new Date().toISOString();
+    health.circuitOpen = false;
+    health.circuitOpenedAt = undefined;
+}
+/**
+ * Record a failed operation for a subsystem.
+ */
+export function recordFailure(name, error) {
+    const health = getOrCreate(name);
+    health.consecutiveFailures++;
+    health.totalFailures++;
+    health.lastError = error;
+    health.lastCheck = new Date().toISOString();
+    if (health.consecutiveFailures >= health.circuitOpensAt) {
+        health.circuitOpen = true;
+        health.circuitOpenedAt = Date.now();
+        health.status = 'unavailable';
+    }
+    else {
+        health.status = 'degraded';
+    }
+}
+/**
+ * Check if a subsystem's circuit breaker allows a call.
+ * Returns true if the call should proceed, false if circuit is open.
+ * Implements half-open: after resetMs, allows one probe call.
+ */
+export function isAvailable(name) {
+    const health = getOrCreate(name);
+    if (!health.circuitOpen)
+        return true;
+    // Half-open check: allow a probe after reset interval
+    if (health.circuitOpenedAt) {
+        const elapsed = Date.now() - health.circuitOpenedAt;
+        if (elapsed >= health.circuitResetMs) {
+            return true; // allow probe — caller must recordSuccess/recordFailure
+        }
+    }
+    return false;
+}
+/**
+ * Get the current health of a subsystem.
+ */
+export function getHealth(name) {
+    return { ...getOrCreate(name) };
+}
+/**
+ * Get a full recovery report across all tracked subsystems.
+ */
+export function getRecoveryReport() {
+    const all = Array.from(subsystems.values()).map((h) => ({ ...h }));
+    const degradedCapabilities = [];
+    let overallStatus = 'healthy';
+    for (const h of all) {
+        if (h.status === 'unavailable') {
+            overallStatus = 'unavailable';
+            degradedCapabilities.push(...getDegradedCapabilities(h.name));
+        }
+        else if (h.status === 'degraded' && overallStatus !== 'unavailable') {
+            overallStatus = 'degraded';
+            degradedCapabilities.push(...getDegradedCapabilities(h.name));
+        }
+    }
+    return {
+        timestamp: new Date().toISOString(),
+        subsystems: all,
+        overallStatus,
+        degradedCapabilities: [...new Set(degradedCapabilities)],
+    };
+}
+/**
+ * Reset a subsystem's health tracking (e.g., after manual recovery).
+ */
+export function resetHealth(name) {
+    subsystems.delete(name);
+}
+/**
+ * Reset all subsystem health tracking.
+ */
+export function resetAllHealth() {
+    subsystems.clear();
+}
+/**
+ * Configure circuit breaker thresholds for a subsystem.
+ */
+export function configureCircuitBreaker(name, options) {
+    const health = getOrCreate(name);
+    if (options.opensAt !== undefined)
+        health.circuitOpensAt = options.opensAt;
+    if (options.resetMs !== undefined)
+        health.circuitResetMs = options.resetMs;
+}
+/**
+ * Wrap an async operation with error recovery.
+ * Records success/failure and returns fallback value when circuit is open.
+ */
+export async function withRecovery(name, operation, fallback) {
+    if (!isAvailable(name)) {
+        return { value: fallback, degraded: true };
+    }
+    try {
+        const value = await operation();
+        recordSuccess(name);
+        return { value, degraded: false };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        recordFailure(name, message);
+        return { value: fallback, degraded: true };
+    }
+}
+/**
+ * Wrap a synchronous operation with error recovery.
+ */
+export function withRecoverySync(name, operation, fallback) {
+    if (!isAvailable(name)) {
+        return { value: fallback, degraded: true };
+    }
+    try {
+        const value = operation();
+        recordSuccess(name);
+        return { value, degraded: false };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        recordFailure(name, message);
+        return { value: fallback, degraded: true };
+    }
+}
+function getDegradedCapabilities(name) {
+    const map = {
+        memory: ['fact storage', 'episodic memory', 'memory search'],
+        ollama: ['vector search', 'semantic similarity', 'HyDE expansion'],
+        swarm: ['multi-agent orchestration', 'DAG execution'],
+        selfheal: ['auto-introspection', 'self-improvement'],
+    };
+    return map[name] ?? [];
+}