@llm-dev-ops/agentics-cli 1.4.26 → 1.4.27

package/dist/bundled-agents/data-vault-agents/dist/ruvector-client/index.js

@@ -0,0 +1,249 @@
+/**
+ * LLM-Data-Vault: RuVector Service Client
+ *
+ * Client for persisting DecisionEvents to ruvector-service.
+ * This is the ONLY persistence mechanism allowed for Data-Vault agents.
+ *
+ * CONSTITUTIONAL REQUIREMENT:
+ * - Data-Vault agents MUST NOT connect directly to Google SQL
+ * - Data-Vault agents persist data ONLY via ruvector-service client calls
+ *
+ * @module ruvector-client
+ */
+import { validateDecisionEvent } from '../contracts/index.js';
+/**
+ * RuVector Service Client
+ *
+ * Provides async, non-blocking persistence for DecisionEvents.
+ */
+export class RuVectorClient {
+    config;
+    constructor(config) {
+        this.config = {
+            endpoint: config.endpoint,
+            apiKey: config.apiKey,
+            timeout: config.timeout ?? 5000,
+            retries: config.retries ?? 3,
+            retryBackoff: config.retryBackoff ?? 1.5,
+        };
+    }
+    /**
+     * Persist a DecisionEvent to ruvector-service
+     *
+     * This is an async, non-blocking write operation.
+     */
+    async persistDecisionEvent(event) {
+        // Validate event before persisting
+        const validatedEvent = validateDecisionEvent(event);
+        let lastError = null;
+        for (let attempt = 0; attempt < this.config.retries; attempt++) {
+            try {
+                const response = await this.makeRequest('/api/v1/decision-events', {
+                    method: 'POST',
+                    body: JSON.stringify(validatedEvent),
+                });
+                if (response.ok) {
+                    const result = await response.json();
+                    return {
+                        success: true,
+                        event_id: result.event_id,
+                        timestamp: result.timestamp,
+                    };
+                }
+                // Handle non-retryable errors
+                if (response.status >= 400 && response.status < 500) {
+                    const errorBody = await response.json().catch(() => ({}));
+                    return {
+                        success: false,
+                        error: {
+                            code: errorBody.code ?? `HTTP_${response.status}`,
+                            message: errorBody.message ?? response.statusText,
+                            retryable: false,
+                        },
+                    };
+                }
+                // Retryable error
+                lastError = new Error(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+            }
+            // Wait before retry
+            if (attempt < this.config.retries - 1) {
+                const delay = Math.pow(this.config.retryBackoff, attempt) * 1000;
+                await new Promise(resolve => setTimeout(resolve, delay));
+            }
+        }
+        return {
+            success: false,
+            error: {
+                code: 'PERSIST_FAILED',
+                message: lastError?.message ?? 'Unknown error',
+                retryable: true,
+            },
+        };
+    }
+    /**
+     * Batch persist multiple DecisionEvents
+     */
+    async persistBatch(events) {
+        // Validate all events
+        const validatedEvents = events.map(e => validateDecisionEvent(e));
+        try {
+            const response = await this.makeRequest('/api/v1/decision-events/batch', {
+                method: 'POST',
+                body: JSON.stringify({ events: validatedEvents }),
+            });
+            if (response.ok) {
+                const results = await response.json();
+                return results.map(r => ({
+                    success: true,
+                    event_id: r.event_id,
+                    timestamp: r.timestamp,
+                }));
+            }
+            const errorBody = await response.json().catch(() => ({}));
+            return events.map(() => ({
+                success: false,
+                error: {
+                    code: errorBody.code ?? `HTTP_${response.status}`,
+                    message: errorBody.message ?? response.statusText,
+                    retryable: response.status >= 500,
+                },
+            }));
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return events.map(() => ({
+                success: false,
+                error: {
+                    code: 'BATCH_PERSIST_FAILED',
+                    message: errorMessage,
+                    retryable: true,
+                },
+            }));
+        }
+    }
+    /**
+     * Query DecisionEvents (for audit/governance consumption)
+     */
+    async queryEvents(options = {}) {
+        const params = new URLSearchParams();
+        if (options.tenant_id)
+            params.set('tenant_id', options.tenant_id);
+        if (options.agent_id)
+            params.set('agent_id', options.agent_id);
+        if (options.decision_type)
+            params.set('decision_type', options.decision_type);
+        if (options.from_timestamp)
+            params.set('from', options.from_timestamp);
+        if (options.to_timestamp)
+            params.set('to', options.to_timestamp);
+        if (options.limit)
+            params.set('limit', String(options.limit));
+        if (options.offset)
+            params.set('offset', String(options.offset));
+        const response = await this.makeRequest(`/api/v1/decision-events?${params}`, {
+            method: 'GET',
+        });
+        if (!response.ok) {
+            throw new Error(`Query failed: HTTP ${response.status}`);
+        }
+        return response.json();
+    }
+    /**
+     * Get a single DecisionEvent by ID
+     */
+    async getEvent(eventId) {
+        const response = await this.makeRequest(`/api/v1/decision-events/${eventId}`, {
+            method: 'GET',
+        });
+        if (response.status === 404) {
+            return null;
+        }
+        if (!response.ok) {
+            throw new Error(`Get event failed: HTTP ${response.status}`);
+        }
+        return validateDecisionEvent(await response.json());
+    }
+    /**
+     * Health check
+     */
+    async healthCheck() {
+        const start = performance.now();
+        try {
+            const response = await this.makeRequest('/health', {
+                method: 'GET',
+            });
+            return {
+                healthy: response.ok,
+                latency_ms: performance.now() - start,
+            };
+        }
+        catch {
+            return {
+                healthy: false,
+                latency_ms: performance.now() - start,
+            };
+        }
+    }
+    /**
+     * Make HTTP request to ruvector-service
+     */
+    async makeRequest(path, options) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+        try {
+            return await fetch(`${this.config.endpoint}${path}`, {
+                ...options,
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${this.config.apiKey}`,
+                    'X-Service': 'llm-data-vault',
+                    ...options.headers,
+                },
+                signal: controller.signal,
+            });
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+}
+/**
+ * Create RuVector client from environment
+ *
+ * STANDARDIZED ENVIRONMENT VARIABLES (matching Google Secret Manager names):
+ * - RUVECTOR_SERVICE_URL: Service endpoint URL (required)
+ * - RUVECTOR_API_KEY: API key for authentication (required, from Secret Manager)
+ *
+ * NOTE: Legacy variable names (RUVECTOR_SERVICE_ENDPOINT, RUVECTOR_SERVICE_API_KEY)
+ * are supported for backward compatibility but deprecated.
+ */
+export function createRuVectorClient() {
+    // Use standardized names, fall back to legacy names for backward compatibility
+    const endpoint = process.env['RUVECTOR_SERVICE_URL']
+        ?? process.env['RUVECTOR_SERVICE_ENDPOINT'];
+    const apiKey = process.env['RUVECTOR_API_KEY']
+        ?? process.env['RUVECTOR_SERVICE_API_KEY'];
+    if (!endpoint) {
+        throw new Error('RUVECTOR_SERVICE_URL environment variable is required');
+    }
+    if (!apiKey) {
+        throw new Error('RUVECTOR_API_KEY environment variable is required (should come from Secret Manager)');
+    }
+    // Warn if using deprecated variable names
+    if (process.env['RUVECTOR_SERVICE_ENDPOINT'] && !process.env['RUVECTOR_SERVICE_URL']) {
+        console.warn('DEPRECATION WARNING: RUVECTOR_SERVICE_ENDPOINT is deprecated, use RUVECTOR_SERVICE_URL');
+    }
+    if (process.env['RUVECTOR_SERVICE_API_KEY'] && !process.env['RUVECTOR_API_KEY']) {
+        console.warn('DEPRECATION WARNING: RUVECTOR_SERVICE_API_KEY is deprecated, use RUVECTOR_API_KEY');
+    }
+    return new RuVectorClient({
+        endpoint,
+        apiKey,
+        timeout: parseInt(process.env['RUVECTOR_TIMEOUT'] ?? '5000', 10),
+        retries: parseInt(process.env['RUVECTOR_RETRIES'] ?? '3', 10),
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/bundled-agents/data-vault-agents/dist/ruvector-client/index.js.map

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

package/dist/bundled-agents/data-vault-agents/dist/startup/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * LLM-Data-Vault: Startup Module
+ *
+ * Exports startup validation and configuration utilities.
+ *
+ * @module startup
+ */
+export { validateEnvironment, checkRuvectorHealth, runStartupValidation, setValidatedConfig, getValidatedConfig, type EnvironmentConfig, type ValidationResult, } from './validation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/bundled-agents/data-vault-agents/dist/startup/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/startup/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC"}

package/dist/bundled-agents/data-vault-agents/dist/startup/index.js

@@ -0,0 +1,9 @@
+/**
+ * LLM-Data-Vault: Startup Module
+ *
+ * Exports startup validation and configuration utilities.
+ *
+ * @module startup
+ */
+export { validateEnvironment, checkRuvectorHealth, runStartupValidation, setValidatedConfig, getValidatedConfig, } from './validation.js';
+//# sourceMappingURL=index.js.map

package/dist/bundled-agents/data-vault-agents/dist/startup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/startup/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,GAGnB,MAAM,iBAAiB,CAAC"}

package/dist/bundled-agents/data-vault-agents/dist/startup/validation.d.ts

@@ -0,0 +1,64 @@
+/**
+ * LLM-Data-Vault: Startup Validation Module
+ *
+ * FAIL-FAST validation for Cloud Run deployment.
+ * Validates all required environment variables and performs health checks.
+ * CRASHES THE PROCESS if any validation fails - this is intentional for Cloud Run.
+ *
+ * @module startup/validation
+ */
+/**
+ * Environment variable configuration
+ */
+export interface EnvironmentConfig {
+    ruvectorServiceUrl: string;
+    ruvectorApiKey: string;
+    agentName: string;
+    agentDomain: string;
+    agentPhase: string;
+    agentLayer: string;
+    agentVersion: string;
+    serviceName: string;
+    serviceVersion: string;
+    platformEnv: string;
+    port: number;
+    telemetryEndpoint?: string;
+    logLevel: 'debug' | 'info' | 'warn' | 'error';
+}
+/**
+ * Validation result
+ */
+export interface ValidationResult {
+    valid: boolean;
+    config?: EnvironmentConfig;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Validate required environment variables
+ * Returns validation result - does NOT crash here
+ */
+export declare function validateEnvironment(): ValidationResult;
+/**
+ * Perform RuVector health check
+ * Returns true if healthy, false otherwise
+ */
+export declare function checkRuvectorHealth(endpoint: string, apiKey: string, timeoutMs?: number): Promise<{
+    healthy: boolean;
+    latencyMs: number;
+    error?: string;
+}>;
+/**
+ * Run complete startup validation
+ *
+ * This function will CRASH THE PROCESS (exit code 1) if:
+ * - Required environment variables are missing
+ * - RuVector service is not reachable
+ *
+ * This is intentional for Cloud Run - we want the container to fail fast
+ * so Cloud Run can retry with a new instance or report the error.
+ */
+export declare function runStartupValidation(): Promise<EnvironmentConfig>;
+export declare function setValidatedConfig(config: EnvironmentConfig): void;
+export declare function getValidatedConfig(): EnvironmentConfig;
+//# sourceMappingURL=validation.d.ts.map

package/dist/bundled-agents/data-vault-agents/dist/startup/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/startup/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAEhC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IAGvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IAGrB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IAGb,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAgCD;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,CAoFtD;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,MAAc,GACxB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA8ClE;AAED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAsKvE;AAQD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAElE;AAED,wBAAgB,kBAAkB,IAAI,iBAAiB,CAMtD"}

package/dist/bundled-agents/data-vault-agents/dist/startup/validation.js

@@ -0,0 +1,319 @@
+/**
+ * LLM-Data-Vault: Startup Validation Module
+ *
+ * FAIL-FAST validation for Cloud Run deployment.
+ * Validates all required environment variables and performs health checks.
+ * CRASHES THE PROCESS if any validation fails - this is intentional for Cloud Run.
+ *
+ * @module startup/validation
+ */
+/**
+ * Log a structured startup event
+ */
+function logStartupEvent(event) {
+    const logLine = JSON.stringify({
+        ...event,
+        timestamp: new Date().toISOString(),
+    });
+    if (event.level === 'ERROR' || event.level === 'FATAL') {
+        console.error(logLine);
+    }
+    else if (event.level === 'WARN') {
+        console.warn(logLine);
+    }
+    else {
+        console.log(logLine);
+    }
+}
+/**
+ * Validate required environment variables
+ * Returns validation result - does NOT crash here
+ */
+export function validateEnvironment() {
+    const errors = [];
+    const warnings = [];
+    // =========================================================================
+    // REQUIRED ENVIRONMENT VARIABLES - CRASH IF MISSING
+    // =========================================================================
+    const ruvectorServiceUrl = process.env['RUVECTOR_SERVICE_URL'];
+    if (!ruvectorServiceUrl) {
+        errors.push('RUVECTOR_SERVICE_URL is required but not set');
+    }
+    else if (!ruvectorServiceUrl.startsWith('http://') && !ruvectorServiceUrl.startsWith('https://')) {
+        errors.push('RUVECTOR_SERVICE_URL must be a valid HTTP(S) URL');
+    }
+    const ruvectorApiKey = process.env['RUVECTOR_API_KEY'];
+    if (!ruvectorApiKey) {
+        errors.push('RUVECTOR_API_KEY is required but not set (should come from Secret Manager)');
+    }
+    else if (ruvectorApiKey === 'placeholder-ruvector-api-key') {
+        errors.push('RUVECTOR_API_KEY contains placeholder value - Secret Manager injection failed');
+    }
+    else if (ruvectorApiKey.length < 16) {
+        errors.push('RUVECTOR_API_KEY appears invalid (too short)');
+    }
+    // =========================================================================
+    // OPTIONAL ENVIRONMENT VARIABLES WITH DEFAULTS
+    // =========================================================================
+    const agentName = process.env['AGENT_NAME'] ?? 'llm-data-vault';
+    const agentDomain = process.env['AGENT_DOMAIN'] ?? 'data-vault';
+    const agentPhase = process.env['AGENT_PHASE'] ?? 'phase7';
+    const agentLayer = process.env['AGENT_LAYER'] ?? 'layer2';
+    const agentVersion = process.env['AGENT_VERSION'] ?? process.env['SERVICE_VERSION'] ?? '0.1.0';
+    const serviceName = process.env['SERVICE_NAME'] ?? 'llm-data-vault';
+    const serviceVersion = process.env['SERVICE_VERSION'] ?? '0.1.0';
+    const platformEnv = process.env['PLATFORM_ENV'] ?? 'dev';
+    const portStr = process.env['PORT'] ?? '8080';
+    const port = parseInt(portStr, 10);
+    if (isNaN(port) || port < 1 || port > 65535) {
+        errors.push(`PORT must be a valid port number (1-65535), got: ${portStr}`);
+    }
+    const telemetryEndpoint = process.env['TELEMETRY_ENDPOINT'];
+    const logLevel = process.env['LOG_LEVEL'] ?? 'info';
+    // =========================================================================
+    // WARNINGS FOR OPTIONAL BUT RECOMMENDED VARIABLES
+    // =========================================================================
+    if (platformEnv === 'production' && !telemetryEndpoint) {
+        warnings.push('TELEMETRY_ENDPOINT not set - telemetry will be disabled in production');
+    }
+    if (!process.env['SERVICE_VERSION']) {
+        warnings.push('SERVICE_VERSION not set - using default version');
+    }
+    // =========================================================================
+    // BUILD CONFIGURATION OBJECT
+    // =========================================================================
+    if (errors.length > 0) {
+        return { valid: false, errors, warnings };
+    }
+    const config = {
+        ruvectorServiceUrl: ruvectorServiceUrl,
+        ruvectorApiKey: ruvectorApiKey,
+        agentName,
+        agentDomain,
+        agentPhase,
+        agentLayer,
+        agentVersion,
+        serviceName,
+        serviceVersion,
+        platformEnv,
+        port,
+        telemetryEndpoint,
+        logLevel,
+    };
+    return { valid: true, config, errors: [], warnings };
+}
+/**
+ * Perform RuVector health check
+ * Returns true if healthy, false otherwise
+ */
+export async function checkRuvectorHealth(endpoint, apiKey, timeoutMs = 10000) {
+    const startTime = performance.now();
+    try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+        const response = await fetch(`${endpoint}/health`, {
+            method: 'GET',
+            headers: {
+                'Authorization': `Bearer ${apiKey}`,
+                'X-Service': 'llm-data-vault',
+            },
+            signal: controller.signal,
+        });
+        clearTimeout(timeoutId);
+        const latencyMs = performance.now() - startTime;
+        if (response.ok) {
+            return { healthy: true, latencyMs };
+        }
+        return {
+            healthy: false,
+            latencyMs,
+            error: `RuVector health check returned HTTP ${response.status}: ${response.statusText}`,
+        };
+    }
+    catch (error) {
+        const latencyMs = performance.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        if (errorMessage.includes('abort')) {
+            return {
+                healthy: false,
+                latencyMs,
+                error: `RuVector health check timed out after ${timeoutMs}ms`,
+            };
+        }
+        return {
+            healthy: false,
+            latencyMs,
+            error: `RuVector health check failed: ${errorMessage}`,
+        };
+    }
+}
+/**
+ * Run complete startup validation
+ *
+ * This function will CRASH THE PROCESS (exit code 1) if:
+ * - Required environment variables are missing
+ * - RuVector service is not reachable
+ *
+ * This is intentional for Cloud Run - we want the container to fail fast
+ * so Cloud Run can retry with a new instance or report the error.
+ */
+export async function runStartupValidation() {
+    const service = process.env['SERVICE_NAME'] ?? 'llm-data-vault';
+    logStartupEvent({
+        timestamp: new Date().toISOString(),
+        level: 'INFO',
+        event: 'STARTUP_VALIDATION_BEGIN',
+        service,
+        phase: 'phase7',
+        details: {
+            nodeVersion: process.version,
+            platform: process.platform,
+            arch: process.arch,
+        },
+    });
+    // =========================================================================
+    // STEP 1: Validate environment variables
+    // =========================================================================
+    logStartupEvent({
+        timestamp: new Date().toISOString(),
+        level: 'INFO',
+        event: 'VALIDATING_ENVIRONMENT',
+        service,
+        phase: 'phase7',
+    });
+    const validation = validateEnvironment();
+    // Log warnings
+    for (const warning of validation.warnings) {
+        logStartupEvent({
+            timestamp: new Date().toISOString(),
+            level: 'WARN',
+            event: 'ENVIRONMENT_WARNING',
+            service,
+            phase: 'phase7',
+            details: { warning },
+        });
+    }
+    // CRASH on validation errors
+    if (!validation.valid) {
+        for (const error of validation.errors) {
+            logStartupEvent({
+                timestamp: new Date().toISOString(),
+                level: 'FATAL',
+                event: 'ENVIRONMENT_VALIDATION_FAILED',
+                service,
+                phase: 'phase7',
+                details: { error },
+            });
+        }
+        console.error('\n========================================');
+        console.error('FATAL: STARTUP VALIDATION FAILED');
+        console.error('========================================');
+        console.error('Missing or invalid environment variables:');
+        for (const error of validation.errors) {
+            console.error(`  - ${error}`);
+        }
+        console.error('========================================');
+        console.error('The service cannot start without proper configuration.');
+        console.error('Ensure Secret Manager secrets are properly configured.');
+        console.error('========================================\n');
+        process.exit(1);
+    }
+    const config = validation.config;
+    logStartupEvent({
+        timestamp: new Date().toISOString(),
+        level: 'INFO',
+        event: 'ENVIRONMENT_VALIDATED',
+        service,
+        phase: 'phase7',
+        details: {
+            ruvectorServiceUrl: config.ruvectorServiceUrl,
+            agentName: config.agentName,
+            agentDomain: config.agentDomain,
+            agentPhase: config.agentPhase,
+            platformEnv: config.platformEnv,
+            // NOTE: Never log API keys
+        },
+    });
+    // =========================================================================
+    // STEP 2: Check RuVector service health
+    // =========================================================================
+    logStartupEvent({
+        timestamp: new Date().toISOString(),
+        level: 'INFO',
+        event: 'CHECKING_RUVECTOR_HEALTH',
+        service,
+        phase: 'phase7',
+        details: { endpoint: config.ruvectorServiceUrl },
+    });
+    const healthCheck = await checkRuvectorHealth(config.ruvectorServiceUrl, config.ruvectorApiKey, 10000 // 10 second timeout for startup
+    );
+    if (!healthCheck.healthy) {
+        logStartupEvent({
+            timestamp: new Date().toISOString(),
+            level: 'FATAL',
+            event: 'RUVECTOR_HEALTH_CHECK_FAILED',
+            service,
+            phase: 'phase7',
+            details: {
+                endpoint: config.ruvectorServiceUrl,
+                latencyMs: healthCheck.latencyMs,
+                error: healthCheck.error,
+            },
+        });
+        console.error('\n========================================');
+        console.error('FATAL: RUVECTOR SERVICE UNREACHABLE');
+        console.error('========================================');
+        console.error(`Endpoint: ${config.ruvectorServiceUrl}`);
+        console.error(`Error: ${healthCheck.error}`);
+        console.error(`Latency: ${healthCheck.latencyMs.toFixed(2)}ms`);
+        console.error('========================================');
+        console.error('The Data-Vault service requires RuVector for persistence.');
+        console.error('Ensure ruvector-service is deployed and accessible.');
+        console.error('========================================\n');
+        process.exit(1);
+    }
+    logStartupEvent({
+        timestamp: new Date().toISOString(),
+        level: 'INFO',
+        event: 'RUVECTOR_HEALTH_CHECK_PASSED',
+        service,
+        phase: 'phase7',
+        details: {
+            endpoint: config.ruvectorServiceUrl,
+            latencyMs: healthCheck.latencyMs,
+        },
+    });
+    // =========================================================================
+    // STEP 3: Startup validation complete
+    // =========================================================================
+    logStartupEvent({
+        timestamp: new Date().toISOString(),
+        level: 'INFO',
+        event: 'STARTUP_VALIDATION_COMPLETE',
+        service,
+        phase: 'phase7',
+        details: {
+            serviceName: config.serviceName,
+            serviceVersion: config.serviceVersion,
+            platformEnv: config.platformEnv,
+            ruvectorLatencyMs: healthCheck.latencyMs,
+        },
+    });
+    return config;
+}
+/**
+ * Get validated configuration synchronously (for use after async validation)
+ * CRASHES if called before runStartupValidation
+ */
+let _validatedConfig = null;
+export function setValidatedConfig(config) {
+    _validatedConfig = config;
+}
+export function getValidatedConfig() {
+    if (!_validatedConfig) {
+        console.error('FATAL: getValidatedConfig called before runStartupValidation');
+        process.exit(1);
+    }
+    return _validatedConfig;
+}
+//# sourceMappingURL=validation.js.map