monora-ai 2.0.0 → 2.1.3

package/dist/bias.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Bias metrics capture for ISO 42001 fairness compliance.
+ *
+ * This module provides bias measurement tracking for AI outputs, supporting
+ * ISO 42001 fairness controls and EU AI Act Article 10 requirements.
+ *
+ * Cross-SDK Parity:
+ *   Both Python and Node.js SDKs provide identical bias metrics APIs:
+ *   - recordBiasMeasurement() / record_bias_measurement()
+ *   - checkThresholdViolations() / check_threshold_violations()
+ *   - BiasMetrics interface / BiasMetrics dataclass
+ */
+import { MonoraConfig } from './config';
+export type MeasurementType = 'demographic_parity' | 'equalized_odds' | 'disparate_impact' | 'custom';
+/**
+ * Bias measurement metrics.
+ */
+export interface BiasMetrics {
+    /** Ratio comparing outcomes across groups (0-1, 1=parity) */
+    demographicParityRatio?: number;
+    /** Difference in true positive rates across groups (0=equal) */
+    equalizedOddsDiff?: number;
+    /** 4/5ths rule ratio (>=0.8 typically required) */
+    disparateImpact?: number;
+    /** Additional custom metric values */
+    customMetrics?: Record<string, number>;
+}
+/**
+ * Convert BiasMetrics to dictionary for event inclusion.
+ */
+export declare function metricsToDict(metrics: BiasMetrics): Record<string, any>;
+/**
+ * A complete bias measurement.
+ */
+export interface BiasMeasurement {
+    /** The model being measured */
+    model: string;
+    /** Type of measurement performed */
+    measurementType: MeasurementType;
+    /** Demographic dimensions measured */
+    dimensions: string[];
+    /** The computed bias metrics */
+    metrics: BiasMetrics;
+    /** Number of samples in the measurement */
+    sampleSize: number;
+    /** Name of the evaluation dataset used */
+    evaluationDataset?: string;
+    /** List of thresholds violated */
+    thresholdViolations: string[];
+    /** When the measurement was taken */
+    timestamp: string;
+}
+/**
+ * Convert BiasMeasurement to event body dictionary.
+ */
+export declare function measurementToEventBody(measurement: BiasMeasurement): Record<string, any>;
+export type BiasCallback = (model: string, inputs: any[], outputs: any[]) => BiasMetrics;
+/**
+ * Options for recording a bias measurement.
+ */
+export interface RecordBiasMeasurementOptions {
+    /** Type of measurement (demographic_parity, equalized_odds, etc.) */
+    measurementType?: MeasurementType;
+    /** Demographic dimensions measured (gender, age_group, etc.) */
+    dimensions?: string[];
+    /** Dict of metric name to value */
+    metrics?: Record<string, number>;
+    /** Number of samples in measurement */
+    sampleSize?: number;
+    /** Name of evaluation dataset */
+    evaluationDataset?: string;
+    /** Optional config (uses runtime state if not provided) */
+    config?: MonoraConfig;
+}
+/**
+ * Record a bias measurement for a model.
+ *
+ * This stores the measurement and checks for threshold violations.
+ *
+ * @param model - The model being measured.
+ * @param options - Measurement options.
+ * @returns The created BiasMeasurement.
+ *
+ * @example
+ * ```typescript
+ * recordBiasMeasurement('gpt-4o', {
+ *   measurementType: 'demographic_parity',
+ *   dimensions: ['gender'],
+ *   metrics: { demographic_parity_ratio: 0.85, sample_size: 500 }
+ * });
+ * ```
+ */
+export declare function recordBiasMeasurement(model: string, options?: RecordBiasMeasurementOptions): BiasMeasurement;
+/**
+ * Check if any bias metrics violate configured thresholds.
+ *
+ * @param metrics - The bias metrics to check.
+ * @param config - The Monora configuration.
+ * @returns List of violated threshold names.
+ */
+export declare function checkThresholdViolations(metrics: BiasMetrics, config: MonoraConfig): string[];
+/**
+ * Set a custom callback for automatic bias measurement.
+ *
+ * The callback is invoked after LLM calls to compute bias metrics
+ * based on inputs and outputs.
+ *
+ * @param callback - Function taking (model, inputs, outputs) => BiasMetrics,
+ *                   or null to clear the callback.
+ */
+export declare function setMeasurementCallback(callback: BiasCallback | null): void;
+/**
+ * Get the current measurement callback.
+ */
+export declare function getMeasurementCallback(): BiasCallback | null;
+/**
+ * Get all recorded bias measurements.
+ */
+export declare function getAllMeasurements(): BiasMeasurement[];
+/**
+ * Clear all stored measurements.
+ */
+export declare function clearMeasurements(): void;
+/**
+ * Get summary of bias measurements for reporting.
+ *
+ * @returns Summary dict for compliance reports.
+ */
+export declare function getBiasSummary(): Record<string, any>;
+//# sourceMappingURL=bias.d.ts.map

package/dist/bias.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bias.d.ts","sourceRoot":"","sources":["../src/bias.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGxC,MAAM,MAAM,eAAe,GAAG,oBAAoB,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,QAAQ,CAAC;AAEtG;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mDAAmD;IACnD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sCAAsC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAoBvE;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,eAAe,EAAE,eAAe,CAAC;IACjC,sCAAsC;IACtC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,gCAAgC;IAChC,OAAO,EAAE,WAAW,CAAC;IACrB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kCAAkC;IAClC,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAWxF;AAMD,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,WAAW,CAAC;AAGzF;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,qEAAqE;IACrE,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2DAA2D;IAC3D,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,4BAAiC,GACzC,eAAe,CA8CjB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,YAAY,GACnB,MAAM,EAAE,CA8CV;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAE1E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,YAAY,GAAG,IAAI,CAE5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,EAAE,CAEtD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAuBpD"}

package/dist/bias.js

@@ -0,0 +1,223 @@
+"use strict";
+/**
+ * Bias metrics capture for ISO 42001 fairness compliance.
+ *
+ * This module provides bias measurement tracking for AI outputs, supporting
+ * ISO 42001 fairness controls and EU AI Act Article 10 requirements.
+ *
+ * Cross-SDK Parity:
+ *   Both Python and Node.js SDKs provide identical bias metrics APIs:
+ *   - recordBiasMeasurement() / record_bias_measurement()
+ *   - checkThresholdViolations() / check_threshold_violations()
+ *   - BiasMetrics interface / BiasMetrics dataclass
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.metricsToDict = metricsToDict;
+exports.measurementToEventBody = measurementToEventBody;
+exports.recordBiasMeasurement = recordBiasMeasurement;
+exports.checkThresholdViolations = checkThresholdViolations;
+exports.setMeasurementCallback = setMeasurementCallback;
+exports.getMeasurementCallback = getMeasurementCallback;
+exports.getAllMeasurements = getAllMeasurements;
+exports.clearMeasurements = clearMeasurements;
+exports.getBiasSummary = getBiasSummary;
+const logger_1 = require("./logger");
+/**
+ * Convert BiasMetrics to dictionary for event inclusion.
+ */
+function metricsToDict(metrics) {
+    const result = {};
+    if (metrics.demographicParityRatio !== undefined) {
+        result.demographic_parity_ratio = metrics.demographicParityRatio;
+    }
+    if (metrics.equalizedOddsDiff !== undefined) {
+        result.equalized_odds_diff = metrics.equalizedOddsDiff;
+    }
+    if (metrics.disparateImpact !== undefined) {
+        result.disparate_impact = metrics.disparateImpact;
+    }
+    if (metrics.customMetrics) {
+        Object.assign(result, metrics.customMetrics);
+    }
+    return result;
+}
+/**
+ * Convert BiasMeasurement to event body dictionary.
+ */
+function measurementToEventBody(measurement) {
+    return {
+        model: measurement.model,
+        measurement_type: measurement.measurementType,
+        dimensions: measurement.dimensions,
+        metrics: metricsToDict(measurement.metrics),
+        sample_size: measurement.sampleSize,
+        evaluation_dataset: measurement.evaluationDataset,
+        threshold_violations: measurement.thresholdViolations,
+        timestamp: measurement.timestamp,
+    };
+}
+// Stored measurements for reporting
+const measurements = [];
+let measurementCallback = null;
+/**
+ * Record a bias measurement for a model.
+ *
+ * This stores the measurement and checks for threshold violations.
+ *
+ * @param model - The model being measured.
+ * @param options - Measurement options.
+ * @returns The created BiasMeasurement.
+ *
+ * @example
+ * ```typescript
+ * recordBiasMeasurement('gpt-4o', {
+ *   measurementType: 'demographic_parity',
+ *   dimensions: ['gender'],
+ *   metrics: { demographic_parity_ratio: 0.85, sample_size: 500 }
+ * });
+ * ```
+ */
+function recordBiasMeasurement(model, options = {}) {
+    const { measurementType = 'custom', dimensions = [], metrics = {}, sampleSize = 0, evaluationDataset, config = {}, } = options;
+    const biasConfig = config.bias || {};
+    // Parse metrics into BiasMetrics
+    const biasMetrics = {
+        demographicParityRatio: metrics.demographic_parity_ratio,
+        equalizedOddsDiff: metrics.equalized_odds_diff,
+        disparateImpact: metrics.disparate_impact,
+        customMetrics: Object.fromEntries(Object.entries(metrics).filter(([k]) => !['demographic_parity_ratio', 'equalized_odds_diff', 'disparate_impact'].includes(k))),
+    };
+    // Check threshold violations
+    const violations = checkThresholdViolations(biasMetrics, config);
+    const measurement = {
+        model,
+        measurementType,
+        dimensions: dimensions.length > 0 ? dimensions : (biasConfig.dimensions || []),
+        metrics: biasMetrics,
+        sampleSize,
+        evaluationDataset,
+        thresholdViolations: violations,
+        timestamp: new Date().toISOString(),
+    };
+    measurements.push(measurement);
+    // Send alert if violations and configured
+    if (violations.length > 0 && (biasConfig.alert_on_violation ?? true)) {
+        sendViolationAlert(measurement, config);
+    }
+    return measurement;
+}
+/**
+ * Check if any bias metrics violate configured thresholds.
+ *
+ * @param metrics - The bias metrics to check.
+ * @param config - The Monora configuration.
+ * @returns List of violated threshold names.
+ */
+function checkThresholdViolations(metrics, config) {
+    const violations = [];
+    const biasConfig = config.bias || {};
+    const thresholds = biasConfig.thresholds || {};
+    // Check demographic parity ratio (must be >= threshold)
+    if (metrics.demographicParityRatio !== undefined) {
+        const threshold = thresholds.demographic_parity_ratio ?? 0.8;
+        if (metrics.demographicParityRatio < threshold) {
+            violations.push(`demographic_parity_ratio (${metrics.demographicParityRatio.toFixed(3)} < ${threshold})`);
+        }
+    }
+    // Check disparate impact (must be >= threshold, typically 0.8 for 4/5ths rule)
+    if (metrics.disparateImpact !== undefined) {
+        const threshold = thresholds.disparate_impact ?? 0.8;
+        if (metrics.disparateImpact < threshold) {
+            violations.push(`disparate_impact (${metrics.disparateImpact.toFixed(3)} < ${threshold})`);
+        }
+    }
+    // Check equalized odds diff (must be <= threshold, lower is better)
+    if (metrics.equalizedOddsDiff !== undefined) {
+        const threshold = thresholds.equalized_odds_diff ?? 0.1;
+        if (metrics.equalizedOddsDiff > threshold) {
+            violations.push(`equalized_odds_diff (${metrics.equalizedOddsDiff.toFixed(3)} > ${threshold})`);
+        }
+    }
+    // Check custom thresholds
+    if (metrics.customMetrics) {
+        for (const [metricName, value] of Object.entries(metrics.customMetrics)) {
+            const threshold = thresholds[metricName];
+            if (threshold !== undefined && value < threshold) {
+                violations.push(`${metricName} (${value.toFixed(3)} < ${threshold})`);
+            }
+        }
+    }
+    return violations;
+}
+/**
+ * Set a custom callback for automatic bias measurement.
+ *
+ * The callback is invoked after LLM calls to compute bias metrics
+ * based on inputs and outputs.
+ *
+ * @param callback - Function taking (model, inputs, outputs) => BiasMetrics,
+ *                   or null to clear the callback.
+ */
+function setMeasurementCallback(callback) {
+    measurementCallback = callback;
+}
+/**
+ * Get the current measurement callback.
+ */
+function getMeasurementCallback() {
+    return measurementCallback;
+}
+/**
+ * Get all recorded bias measurements.
+ */
+function getAllMeasurements() {
+    return [...measurements];
+}
+/**
+ * Clear all stored measurements.
+ */
+function clearMeasurements() {
+    measurements.length = 0;
+}
+/**
+ * Get summary of bias measurements for reporting.
+ *
+ * @returns Summary dict for compliance reports.
+ */
+function getBiasSummary() {
+    if (measurements.length === 0) {
+        return {
+            measurements_recorded: 0,
+            threshold_violations: 0,
+            dimensions_measured: [],
+        };
+    }
+    const allDimensions = new Set();
+    let totalViolations = 0;
+    for (const m of measurements) {
+        m.dimensions.forEach((d) => allDimensions.add(d));
+        totalViolations += m.thresholdViolations.length;
+    }
+    return {
+        measurements_recorded: measurements.length,
+        threshold_violations: totalViolations,
+        dimensions_measured: Array.from(allDimensions).sort(),
+        models_measured: Array.from(new Set(measurements.map((m) => m.model))),
+    };
+}
+/**
+ * Send alert for threshold violations.
+ */
+function sendViolationAlert(measurement, config) {
+    try {
+        const alertConfig = config.alerts;
+        if (!alertConfig?.violation_webhook) {
+            return;
+        }
+        // Log the violation - actual alert sending would use the alerts module
+        logger_1.logger.warning('Bias threshold violations detected for model %s: %s', measurement.model, measurement.thresholdViolations.join(', '));
+    }
+    catch (error) {
+        logger_1.logger.warning('Failed to send bias violation alert: %s', error);
+    }
+}

package/dist/circuit_breaker.js

@@ -110,7 +110,7 @@ class CircuitBreaker {
      * In closed state, resets failure count.
      */
     recordSuccess() {
-        if (this._state === CircuitState.HALF_OPEN) {
+        if (this.state === CircuitState.HALF_OPEN) {
             this._successCount++;
             logger_1.logger.debug('[%s] Success recorded in HALF_OPEN (%d/%d)', this.name, this._successCount, this.successThreshold);
             if (this._successCount >= this.successThreshold) {
@@ -119,7 +119,7 @@ class CircuitBreaker {
                 this._failureCount = 0;
             }
         }
-        else if (this._state === CircuitState.CLOSED) {
+        else if (this.state === CircuitState.CLOSED) {
             // Reset failure count on success
             this._failureCount = 0;
         }
@@ -133,7 +133,7 @@ class CircuitBreaker {
     recordFailure() {
         this._failureCount++;
         this._lastFailureTime = Date.now();
-        if (this._state === CircuitState.HALF_OPEN) {
+        if (this.state === CircuitState.HALF_OPEN) {
             logger_1.logger.warning('[%s] Circuit reopening HALF_OPEN -> OPEN after failure', this.name);
             this._state = CircuitState.OPEN;
         }

package/dist/cli/diagnostics.d.ts

@@ -2,13 +2,17 @@
  * Configuration diagnostics and validation.
  */
 import { MonoraConfig } from '../config';
+import { ValidationMode } from '../config_schema';
 interface ValidationResult {
     errors: string[];
     warnings: string[];
 }
-export declare function validateConfig(config: MonoraConfig): ValidationResult;
+export declare function validateConfig(config: MonoraConfig, options?: {
+    mode?: ValidationMode;
+}): ValidationResult;
 export declare function doctorChecks(config: MonoraConfig, options?: {
     checkNetwork?: boolean;
+    mode?: ValidationMode;
 }): ValidationResult;
 export declare function emitResults(results: ValidationResult, options?: {
     json?: boolean;

package/dist/cli/diagnostics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/cli/diagnostics.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAc,YAAY,EAAE,MAAM,WAAW,CAAC;AAQrD,UAAU,gBAAgB;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,gBAAgB,CA4IrE;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GACnC,gBAAgB,CAqDlB;AA+CD,wBAAgB,WAAW,CACzB,OAAO,EAAE,gBAAgB,EACzB,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAC3B,MAAM,CAqCR"}
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/cli/diagnostics.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAyB,cAAc,EAA4C,MAAM,kBAAkB,CAAC;AAQnH,UAAU,gBAAgB;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,cAAc,CAAA;CAAE,GAAG,gBAAgB,CAmK1G;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,cAAc,CAAA;CAAE,GAC1D,gBAAgB,CAqDlB;AA+CD,wBAAgB,WAAW,CACzB,OAAO,EAAE,gBAAgB,EACzB,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAC3B,MAAM,CAqCR"}

package/dist/cli/diagnostics.js

@@ -42,17 +42,35 @@ exports.emitResults = emitResults;
 const fs = __importStar(require("fs"));
 const net = __importStar(require("net"));
 const url_1 = require("url");
-const schema_validation_1 = require("../schema_validation");
+const config_schema_1 = require("../config_schema");
+const config_migrations_1 = require("../config_migrations");
 const ALLOWED_QUEUE_MODES = new Set(['warn', 'raise', 'block']);
 const ALLOWED_SINK_FAILURE_MODES = new Set(['warn', 'raise', 'silent']);
 const ALLOWED_ROTATION = new Set(['none', 'daily', 'size']);
 const ALLOWED_DATA_HANDLING = new Set(['redact', 'block', 'allow']);
-function validateConfig(config) {
+function validateConfig(config, options) {
     const errors = [];
     const warnings = [];
-    const schemaError = (0, schema_validation_1.validateConfigSchema)(config);
-    if (schemaError) {
-        errors.push(`schema: ${schemaError}`);
+    const mode = options?.mode || 'strict';
+    const schemaWarnings = [];
+    try {
+        (0, config_schema_1.validateConfig)(config, {
+            mode,
+            logger: { warn: (message) => schemaWarnings.push(message) },
+        });
+    }
+    catch (error) {
+        if (error instanceof config_schema_1.ConfigValidationError) {
+            for (const issue of error.errors) {
+                errors.push(`schema: ${issue.path.join('.')}: ${issue.message}`);
+            }
+        }
+        else {
+            errors.push(`schema: ${error?.message || error}`);
+        }
+    }
+    if (schemaWarnings.length > 0) {
+        warnings.push(...schemaWarnings);
     }
     // Validate sinks
     const sinks = config.sinks || [];
@@ -80,7 +98,7 @@ function validateConfig(config) {
             }
             continue;
         }
-        if (sinkType === 'https') {
+        if (sinkType === 'https' || sinkType === 'http') {
             const endpoint = sink.endpoint;
             if (!endpoint) {
                 errors.push(`${prefix}: https sink requires 'endpoint'.`);
@@ -167,11 +185,16 @@ function validateConfig(config) {
     if (instrumentation.enabled && !instrumentation.targets?.length) {
         warnings.push('instrumentation.enabled true but no targets configured.');
     }
+    // Production readiness warnings
+    const readinessWarnings = (0, config_migrations_1.validateProductionReadiness)(config);
+    for (const warning of readinessWarnings) {
+        warnings.push(`production: [${warning.category}] ${warning.message} (recommendation: ${warning.recommendation})`);
+    }
     return { errors, warnings };
 }
 function doctorChecks(config, options) {
     const checkNetwork = options?.checkNetwork ?? true;
-    const result = validateConfig(config);
+    const result = validateConfig(config, { mode: options?.mode });
     const errors = [...result.errors];
     const warnings = [...result.warnings];
     // Check axios for HTTPS sink
@@ -187,7 +210,7 @@ function doctorChecks(config, options) {
                 errors.push(`${prefix}: cannot write to ${path}.`);
             }
         }
-        if (sinkType === 'https') {
+        if (sinkType === 'https' || sinkType === 'http') {
             if (!axiosAvailable) {
                 errors.push(`${prefix}: axios not installed (required for HTTPS sink).`);
             }

package/dist/cli/doctor.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Config doctor checks for Monora CLI.
+ */
+import { ValidationMode } from '../config_schema';
+export interface DoctorCheck {
+    name: string;
+    ok: boolean;
+    level: 'error' | 'warning';
+    message: string;
+    recommendation?: string;
+}
+export interface DoctorResult {
+    ok: boolean;
+    errors: string[];
+    warnings: string[];
+    checks: DoctorCheck[];
+}
+export declare function doctorChecks(configPath: string, options?: {
+    checkNetwork?: boolean;
+    mode?: ValidationMode;
+}): Promise<DoctorResult>;
+export declare function emitDoctorResults(result: DoctorResult, options?: {
+    json?: boolean;
+}): number;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/cli/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/cli/doctor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,OAAO,EAAyB,cAAc,EAAkB,MAAM,kBAAkB,CAAC;AAEzF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAID,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,cAAc,CAAA;CAAE,GAC1D,OAAO,CAAC,YAAY,CAAC,CAgHvB;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAkC5F"}