@fulmenhq/tsfulmen 0.3.2 → 0.4.0

package/dist/telemetry/index.js

@@ -1,1563 +1,6 @@
-import { readFile, access } from 'fs/promises';
-import { join, dirname, relative, extname } from 'path';
-import { parse } from 'yaml';
-import addFormats from 'ajv-formats';
-import 'child_process';
-import { fileURLToPath } from 'url';
-import glob from 'fast-glob';
-import Ajv from 'ajv';
-import Ajv2019 from 'ajv/dist/2019.js';
-import Ajv2020 from 'ajv/dist/2020.js';
-import AjvDraft04 from 'ajv-draft-04';
-import 'commander';
-
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __esm = (fn, res) => function __init() {
-  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
-};
-
-// src/telemetry/counter.ts
-var Counter;
-var init_counter = __esm({
-  "src/telemetry/counter.ts"() {
-    Counter = class {
-      constructor(name) {
-        this.name = name;
-      }
-      value = 0;
-      labeledValues = /* @__PURE__ */ new Map();
-      /**
-       * Increment counter by delta (default: 1)
-       *
-       * @param delta - Amount to increment (must be non-negative)
-       * @param labels - Optional label dimensions for this observation
-       * @throws {Error} If delta is negative
-       *
-       * @example
-       * ```typescript
-       * counter.inc();                              // Increment unlabeled by 1
-       * counter.inc(5);                             // Increment unlabeled by 5
-       * counter.inc(1, { status: '200' });          // Increment labeled instance
-       * counter.inc(1, { result: 'success' });      // Different label set
-       * ```
-       */
-      inc(delta = 1, labels) {
-        if (delta < 0) {
-          throw new Error(`Counter delta must be non-negative, got: ${delta}`);
-        }
-        if (labels && Object.keys(labels).length > 0) {
-          const labelKey = this.serializeLabels(labels);
-          const current = this.labeledValues.get(labelKey) || 0;
-          this.labeledValues.set(labelKey, current + delta);
-        } else {
-          this.value += delta;
-        }
-      }
-      /**
-       * Get current counter value (unlabeled)
-       */
-      getValue() {
-        return this.value;
-      }
-      /**
-       * Get all labeled values
-       * @returns Map of serialized label keys to values
-       */
-      getLabeledValues() {
-        return new Map(this.labeledValues);
-      }
-      /**
-       * Get value for specific label combination
-       */
-      getValueForLabels(labels) {
-        const labelKey = this.serializeLabels(labels);
-        return this.labeledValues.get(labelKey) || 0;
-      }
-      /**
-       * Reset counter to zero (all label combinations)
-       */
-      reset() {
-        this.value = 0;
-        this.labeledValues.clear();
-      }
-      /**
-       * Serialize labels to deterministic string key
-       * Format: key1=value1,key2=value2 (sorted by key)
-       */
-      serializeLabels(labels) {
-        return Object.entries(labels).sort(([a], [b]) => a.localeCompare(b)).map(([k, v]) => `${k}=${v}`).join(",");
-      }
-    };
-  }
-});
-
-// src/telemetry/gauge.ts
-var Gauge;
-var init_gauge = __esm({
-  "src/telemetry/gauge.ts"() {
-    Gauge = class {
-      constructor(name) {
-        this.name = name;
-      }
-      value = 0;
-      labeledValues = /* @__PURE__ */ new Map();
-      /**
-       * Set gauge to specific value
-       *
-       * @param value - New gauge value (can be any number, including negative)
-       * @param labels - Optional label dimensions for this observation
-       *
-       * @example
-       * ```typescript
-       * gauge.set(42);                              // Set unlabeled to 42
-       * gauge.set(-10);                             // Negative values allowed
-       * gauge.set(1, { phase: 'collect' });         // Set labeled instance
-       * ```
-       */
-      set(value, labels) {
-        if (labels && Object.keys(labels).length > 0) {
-          const labelKey = this.serializeLabels(labels);
-          this.labeledValues.set(labelKey, value);
-        } else {
-          this.value = value;
-        }
-      }
-      /**
-       * Increment gauge by delta (default: 1)
-       *
-       * @param delta - Amount to increment (can be negative)
-       * @param labels - Optional label dimensions for this observation
-       */
-      inc(delta = 1, labels) {
-        if (labels && Object.keys(labels).length > 0) {
-          const labelKey = this.serializeLabels(labels);
-          const current = this.labeledValues.get(labelKey) || 0;
-          this.labeledValues.set(labelKey, current + delta);
-        } else {
-          this.value += delta;
-        }
-      }
-      /**
-       * Decrement gauge by delta (default: 1)
-       *
-       * @param delta - Amount to decrement (can be negative)
-       * @param labels - Optional label dimensions for this observation
-       */
-      dec(delta = 1, labels) {
-        if (labels && Object.keys(labels).length > 0) {
-          const labelKey = this.serializeLabels(labels);
-          const current = this.labeledValues.get(labelKey) || 0;
-          this.labeledValues.set(labelKey, current - delta);
-        } else {
-          this.value -= delta;
-        }
-      }
-      /**
-       * Get current gauge value (unlabeled)
-       */
-      getValue() {
-        return this.value;
-      }
-      /**
-       * Get all labeled values
-       * @returns Map of serialized label keys to values
-       */
-      getLabeledValues() {
-        return new Map(this.labeledValues);
-      }
-      /**
-       * Get value for specific label combination
-       */
-      getValueForLabels(labels) {
-        const labelKey = this.serializeLabels(labels);
-        return this.labeledValues.get(labelKey) || 0;
-      }
-      /**
-       * Reset gauge to zero (all label combinations)
-       */
-      reset() {
-        this.value = 0;
-        this.labeledValues.clear();
-      }
-      /**
-       * Serialize labels to deterministic string key
-       * Format: key1=value1,key2=value2 (sorted by key)
-       */
-      serializeLabels(labels) {
-        return Object.entries(labels).sort(([a], [b]) => a.localeCompare(b)).map(([k, v]) => `${k}=${v}`).join(",");
-      }
-    };
-  }
-});
-async function getTaxonomy() {
-  return TaxonomyLoader.getInstance().getTaxonomy();
-}
-async function getMetric(name) {
-  return TaxonomyLoader.getInstance().getMetric(name);
-}
-async function getDefaultUnit(name) {
-  return TaxonomyLoader.getInstance().getDefaultUnit(name);
-}
-async function getDefaultBuckets(name) {
-  return TaxonomyLoader.getInstance().getDefaultBuckets(name);
-}
-async function isValidMetricName(name) {
-  return TaxonomyLoader.getInstance().isValidMetricName(name);
-}
-var DEFAULT_MS_BUCKETS, TaxonomyLoader;
-var init_taxonomy = __esm({
-  "src/telemetry/taxonomy.ts"() {
-    DEFAULT_MS_BUCKETS = [1, 5, 10, 50, 100, 500, 1e3, 5e3, 1e4];
-    TaxonomyLoader = class _TaxonomyLoader {
-      static instance;
-      taxonomy = null;
-      loadPromise = null;
-      loadError = null;
-      constructor() {
-      }
-      /**
-       * Get singleton instance
-       */
-      static getInstance() {
-        if (!_TaxonomyLoader.instance) {
-          _TaxonomyLoader.instance = new _TaxonomyLoader();
-        }
-        return _TaxonomyLoader.instance;
-      }
-      /**
-       * Load taxonomy from YAML file
-       */
-      async load() {
-        if (this.taxonomy !== null) {
-          return this.taxonomy;
-        }
-        if (this.loadError !== null) {
-          throw this.loadError;
-        }
-        if (this.loadPromise) {
-          return this.loadPromise;
-        }
-        this.loadPromise = (async () => {
-          try {
-            const taxonomyPath = join(
-              __dirname,
-              "..",
-              "..",
-              "config",
-              "crucible-ts",
-              "taxonomy",
-              "metrics.yaml"
-            );
-            const content = await readFile(taxonomyPath, "utf-8");
-            this.taxonomy = parse(content);
-            return this.taxonomy;
-          } catch (err) {
-            this.loadError = err instanceof Error ? err : new Error(String(err));
-            throw new Error(`Failed to load metrics taxonomy: ${this.loadError.message}`);
-          }
-        })();
-        return this.loadPromise;
-      }
-      /**
-       * Get taxonomy (async)
-       */
-      async getTaxonomy() {
-        return this.load();
-      }
-      /**
-       * Get metric definition by name
-       */
-      async getMetric(name) {
-        const taxonomy = await this.load();
-        return taxonomy.metrics.find((m) => m.name === name);
-      }
-      /**
-       * Get default unit for metric
-       */
-      async getDefaultUnit(name) {
-        const metric = await this.getMetric(name);
-        return metric?.unit;
-      }
-      /**
-       * Get default histogram buckets for metric
-       * Returns ADR-0007 buckets for _ms metrics, undefined for others
-       */
-      async getDefaultBuckets(name) {
-        if (name.endsWith("_ms")) {
-          const taxonomy = await this.load();
-          return taxonomy.defaults.histogram_buckets.ms_metrics;
-        }
-        return void 0;
-      }
-      /**
-       * Check if metric name is valid (exists in taxonomy)
-       */
-      async isValidMetricName(name) {
-        try {
-          const taxonomy = await this.load();
-          return taxonomy.metrics.some((m) => m.name === name);
-        } catch {
-          return false;
-        }
-      }
-      /**
-       * Reset loader state (for testing)
-       * @internal
-       */
-      static _reset() {
-        _TaxonomyLoader.instance = new _TaxonomyLoader();
-      }
-    };
-  }
-});
-
-// src/telemetry/histogram.ts
-var Histogram;
-var init_histogram = __esm({
-  "src/telemetry/histogram.ts"() {
-    init_taxonomy();
-    Histogram = class {
-      constructor(name, options) {
-        this.name = name;
-        if (options?.buckets) {
-          this.buckets = [...options.buckets].sort((a, b) => a - b);
-        } else if (name.endsWith("_ms") || name.endsWith("_seconds")) {
-          this.buckets = [...DEFAULT_MS_BUCKETS];
-        } else {
-          this.buckets = [];
-        }
-        for (const bucket of this.buckets) {
-          this.bucketCounts.set(bucket, 0);
-        }
-      }
-      count = 0;
-      sum = 0;
-      bucketCounts = /* @__PURE__ */ new Map();
-      labeledStates = /* @__PURE__ */ new Map();
-      buckets;
-      /**
-       * Record an observation
-       *
-       * @param value - Value to observe (typically a duration in ms or seconds)
-       * @param labels - Optional label dimensions for this observation
-       *
-       * @example
-       * ```typescript
-       * const start = performance.now();
-       * // ... operation ...
-       * histogram.observe(performance.now() - start);
-       * histogram.observe(duration, { phase: 'collect', result: 'success' });
-       * ```
-       */
-      observe(value, labels) {
-        if (labels && Object.keys(labels).length > 0) {
-          const labelKey = this.serializeLabels(labels);
-          let state = this.labeledStates.get(labelKey);
-          if (!state) {
-            state = {
-              count: 0,
-              sum: 0,
-              bucketCounts: /* @__PURE__ */ new Map()
-            };
-            for (const bucket of this.buckets) {
-              state.bucketCounts.set(bucket, 0);
-            }
-            this.labeledStates.set(labelKey, state);
-          }
-          state.count++;
-          state.sum += value;
-          for (const bucket of this.buckets) {
-            if (value <= bucket) {
-              state.bucketCounts.set(bucket, (state.bucketCounts.get(bucket) || 0) + 1);
-            }
-          }
-        } else {
-          this.count++;
-          this.sum += value;
-          for (const bucket of this.buckets) {
-            if (value <= bucket) {
-              this.bucketCounts.set(bucket, (this.bucketCounts.get(bucket) || 0) + 1);
-            }
-          }
-        }
-      }
-      /**
-       * Get histogram summary
-       *
-       * Returns OTLP-compatible histogram summary with cumulative bucket counts.
-       */
-      getSummary() {
-        const buckets = this.buckets.map((le) => ({
-          le,
-          count: this.bucketCounts.get(le) || 0
-        }));
-        return {
-          count: this.count,
-          sum: this.sum,
-          buckets
-        };
-      }
-      /**
-       * Get current observation count
-       */
-      getCount() {
-        return this.count;
-      }
-      /**
-       * Get sum of all observed values
-       */
-      getSum() {
-        return this.sum;
-      }
-      /**
-       * Get average of observed values
-       */
-      getAverage() {
-        return this.count > 0 ? this.sum / this.count : 0;
-      }
-      /**
-       * Get all labeled summaries
-       * @returns Map of serialized label keys to histogram summaries
-       */
-      getLabeledSummaries() {
-        const summaries = /* @__PURE__ */ new Map();
-        for (const [labelKey, state] of this.labeledStates) {
-          const buckets = this.buckets.map((le) => ({
-            le,
-            count: state.bucketCounts.get(le) || 0
-          }));
-          summaries.set(labelKey, {
-            count: state.count,
-            sum: state.sum,
-            buckets
-          });
-        }
-        return summaries;
-      }
-      /**
-       * Get summary for specific label combination
-       */
-      getSummaryForLabels(labels) {
-        const labelKey = this.serializeLabels(labels);
-        const state = this.labeledStates.get(labelKey);
-        if (!state) {
-          return null;
-        }
-        const buckets = this.buckets.map((le) => ({
-          le,
-          count: state.bucketCounts.get(le) || 0
-        }));
-        return {
-          count: state.count,
-          sum: state.sum,
-          buckets
-        };
-      }
-      /**
-       * Reset histogram to initial state (all label combinations)
-       */
-      reset() {
-        this.count = 0;
-        this.sum = 0;
-        for (const bucket of this.buckets) {
-          this.bucketCounts.set(bucket, 0);
-        }
-        this.labeledStates.clear();
-      }
-      /**
-       * Serialize labels to deterministic string key
-       * Format: key1=value1,key2=value2 (sorted by key)
-       */
-      serializeLabels(labels) {
-        return Object.entries(labels).sort(([a], [b]) => a.localeCompare(b)).map(([k, v]) => `${k}=${v}`).join(",");
-      }
-    };
-  }
-});
-
-// src/telemetry/registry.ts
-var MetricsRegistry;
-var init_registry = __esm({
-  "src/telemetry/registry.ts"() {
-    init_counter();
-    init_gauge();
-    init_histogram();
-    init_taxonomy();
-    MetricsRegistry = class {
-      counters = /* @__PURE__ */ new Map();
-      gauges = /* @__PURE__ */ new Map();
-      histograms = /* @__PURE__ */ new Map();
-      /**
-       * Get or create a counter
-       *
-       * @param name - Metric name from taxonomy
-       * @returns Counter instance
-       *
-       * @example
-       * ```typescript
-       * const counter = registry.counter('schema_validations');
-       * counter.inc();
-       * ```
-       */
-      counter(name) {
-        let counter = this.counters.get(name);
-        if (!counter) {
-          counter = new Counter(name);
-          this.counters.set(name, counter);
-        }
-        return counter;
-      }
-      /**
-       * Get or create a gauge
-       *
-       * @param name - Metric name from taxonomy
-       * @returns Gauge instance
-       *
-       * @example
-       * ```typescript
-       * const gauge = registry.gauge('foundry_lookup_count');
-       * gauge.set(42);
-       * ```
-       */
-      gauge(name) {
-        let gauge = this.gauges.get(name);
-        if (!gauge) {
-          gauge = new Gauge(name);
-          this.gauges.set(name, gauge);
-        }
-        return gauge;
-      }
-      /**
-       * Get or create a histogram
-       *
-       * @param name - Metric name from taxonomy
-       * @param options - Optional histogram options
-       * @returns Histogram instance
-       *
-       * @example
-       * ```typescript
-       * // Auto-applies ADR-0007 buckets for _ms metrics
-       * const histogram = registry.histogram('config_load_ms');
-       * histogram.observe(42.5);
-       *
-       * // Custom buckets
-       * const custom = registry.histogram('custom_metric', {
-       *   buckets: [10, 50, 100, 500, 1000]
-       * });
-       * ```
-       */
-      histogram(name, options) {
-        let histogram = this.histograms.get(name);
-        if (!histogram) {
-          histogram = new Histogram(name, options);
-          this.histograms.set(name, histogram);
-        }
-        return histogram;
-      }
-      /**
-       * Export all metrics as events
-       *
-       * Returns array of schema-compliant MetricsEvent objects.
-       * Does not clear metrics (use flush() to clear after export).
-       *
-       * @returns Promise resolving to array of metrics events
-       *
-       * @example
-       * ```typescript
-       * const events = await registry.export();
-       * console.log(JSON.stringify(events, null, 2));
-       * ```
-       */
-      async export() {
-        const events = [];
-        const timestamp = (/* @__PURE__ */ new Date()).toISOString();
-        for (const [name, counter] of this.counters) {
-          const unit = await getDefaultUnit(name);
-          events.push({
-            timestamp,
-            name,
-            value: counter.getValue(),
-            unit
-          });
-          for (const [labelKey, value] of counter.getLabeledValues()) {
-            if (value > 0) {
-              const tags = this.deserializeLabels(labelKey);
-              events.push({
-                timestamp,
-                name,
-                value,
-                tags,
-                unit
-              });
-            }
-          }
-        }
-        for (const [name, gauge] of this.gauges) {
-          const unit = await getDefaultUnit(name);
-          events.push({
-            timestamp,
-            name,
-            value: gauge.getValue(),
-            unit
-          });
-          for (const [labelKey, value] of gauge.getLabeledValues()) {
-            const tags = this.deserializeLabels(labelKey);
-            events.push({
-              timestamp,
-              name,
-              value,
-              tags,
-              unit
-            });
-          }
-        }
-        for (const [name, histogram] of this.histograms) {
-          const unit = await getDefaultUnit(name);
-          events.push({
-            timestamp,
-            name,
-            value: histogram.getSummary(),
-            unit
-          });
-          for (const [labelKey, summary] of histogram.getLabeledSummaries()) {
-            if (summary.count > 0) {
-              const tags = this.deserializeLabels(labelKey);
-              events.push({
-                timestamp,
-                name,
-                value: summary,
-                tags,
-                unit
-              });
-            }
-          }
-        }
-        return events;
-      }
-      /**
-       * Deserialize label key back to tags object
-       * Format: key1=value1,key2=value2 → {key1: "value1", key2: "value2"}
-       */
-      deserializeLabels(labelKey) {
-        if (!labelKey) {
-          return {};
-        }
-        const tags = {};
-        for (const pair of labelKey.split(",")) {
-          const [key, value] = pair.split("=");
-          if (key && value) {
-            tags[key] = value;
-          }
-        }
-        return tags;
-      }
-      /**
-       * Export and clear all metrics
-       *
-       * Exports metrics as events, optionally emits them via logger,
-       * then resets all metrics to zero.
-       *
-       * @param options - Flush options
-       * @returns Promise resolving to array of exported events
-       *
-       * @example
-       * ```typescript
-       * // Export and clear
-       * const events = await registry.flush();
-       *
-       * // Export, emit to logger, and clear
-       * const events = await registry.flush({
-       *   emit: (events) => console.log(JSON.stringify(events))
-       * });
-       * ```
-       */
-      async flush(options) {
-        const events = await this.export();
-        try {
-          if (options?.emit) {
-            options.emit(events);
-          }
-        } finally {
-          this.clear();
-        }
-        return events;
-      }
-      /**
-       * Clear all metrics (reset to zero)
-       *
-       * Resets all counters, gauges, and histograms to their initial state.
-       */
-      clear() {
-        for (const counter of this.counters.values()) {
-          counter.reset();
-        }
-        for (const gauge of this.gauges.values()) {
-          gauge.reset();
-        }
-        for (const histogram of this.histograms.values()) {
-          histogram.reset();
-        }
-      }
-      /**
-       * Get all registered metric names
-       *
-       * Returns array of all metric names that have been accessed
-       * (counters, gauges, or histograms).
-       */
-      getMetricNames() {
-        const names = /* @__PURE__ */ new Set();
-        for (const name of this.counters.keys()) {
-          names.add(name);
-        }
-        for (const name of this.gauges.keys()) {
-          names.add(name);
-        }
-        for (const name of this.histograms.keys()) {
-          names.add(name);
-        }
-        return Array.from(names);
-      }
-      /**
-       * Get total count of registered metrics
-       */
-      getMetricCount() {
-        return this.counters.size + this.gauges.size + this.histograms.size;
-      }
-    };
-  }
-});
-
-// src/telemetry/types.ts
-function isHistogramSummary(value) {
-  return typeof value === "object" && value !== null && "count" in value && "sum" in value && "buckets" in value;
-}
-function isValidMetricName2(name) {
-  const validNames = [
-    // Core module metrics
-    "schema_validations",
-    "schema_validation_errors",
-    "config_load_ms",
-    "config_load_errors",
-    "pathfinder_find_ms",
-    "pathfinder_validation_errors",
-    "pathfinder_security_warnings",
-    "foundry_lookup_count",
-    "logging_emit_count",
-    "logging_emit_latency_ms",
-    "goneat_command_duration_ms",
-    // Prometheus exporter metrics
-    "prometheus_exporter_refresh_duration_seconds",
-    "prometheus_exporter_refresh_total",
-    "prometheus_exporter_refresh_errors_total",
-    "prometheus_exporter_refresh_inflight",
-    "prometheus_exporter_http_requests_total",
-    "prometheus_exporter_http_errors_total",
-    "prometheus_exporter_restarts_total",
-    // Foundry MIME detection metrics
-    "foundry_mime_detections_total_json",
-    "foundry_mime_detections_total_xml",
-    "foundry_mime_detections_total_yaml",
-    "foundry_mime_detections_total_csv",
-    "foundry_mime_detections_total_plain_text",
-    "foundry_mime_detections_total_unknown",
-    "foundry_mime_detection_ms_json",
-    "foundry_mime_detection_ms_xml",
-    "foundry_mime_detection_ms_yaml",
-    "foundry_mime_detection_ms_csv",
-    "foundry_mime_detection_ms_plain_text",
-    "foundry_mime_detection_ms_unknown",
-    // Error handling metrics
-    "error_handling_wraps_total",
-    "error_handling_wrap_ms",
-    // FulHash metrics
-    "fulhash_operations_total_xxh3_128",
-    "fulhash_operations_total_sha256",
-    "fulhash_hash_string_total",
-    "fulhash_bytes_hashed_total",
-    "fulhash_operation_ms",
-    // HTTP server metrics
-    "http_requests_total",
-    "http_request_duration_seconds",
-    "http_request_size_bytes",
-    "http_response_size_bytes",
-    "http_active_requests"
-  ];
-  return validNames.includes(name);
-}
-function isValidMetricUnit(unit) {
-  const validUnits = ["count", "ms", "bytes", "percent", "s"];
-  return validUnits.includes(unit);
-}
-var init_types = __esm({
-  "src/telemetry/types.ts"() {
-  }
-});
-function applyFulmenAjvFormats(ajv, options = {}) {
-  const mode = options.mode ?? "fast";
-  const formats = options.formats ?? DEFAULT_FORMATS;
-  addFormats(ajv, { mode, formats });
-  return ajv;
-}
-var DEFAULT_FORMATS;
-var init_ajv_formats = __esm({
-  "src/schema/ajv-formats.ts"() {
-    DEFAULT_FORMATS = [
-      "date-time",
-      "email",
-      "hostname",
-      "ipv4",
-      "ipv6",
-      "uri",
-      "uri-reference",
-      "uuid"
-    ];
-  }
-});
-
-// src/schema/errors.ts
-var SchemaValidationError;
-var init_errors = __esm({
-  "src/schema/errors.ts"() {
-    SchemaValidationError = class _SchemaValidationError extends Error {
-      constructor(message, schemaId, diagnostics = [], source, cause) {
-        super(message);
-        this.schemaId = schemaId;
-        this.diagnostics = diagnostics;
-        this.source = source;
-        this.cause = cause;
-        this.name = "SchemaValidationError";
-        if (Error.captureStackTrace) {
-          Error.captureStackTrace(this, _SchemaValidationError);
-        }
-      }
-      /**
-       * Create error for schema not found
-       */
-      static schemaNotFound(schemaId) {
-        return new _SchemaValidationError(`Schema not found: ${schemaId}`, schemaId);
-      }
-      /**
-       * Create error for invalid schema input
-       */
-      static invalidSchemaInput(source, details) {
-        return new _SchemaValidationError(`Invalid schema input: ${details}`, void 0, [], source);
-      }
-      /**
-       * Create error for validation failure
-       */
-      static validationFailed(schemaId, diagnostics, source) {
-        const errorCount = diagnostics.filter((d) => d.severity === "ERROR").length;
-        const warningCount = diagnostics.filter((d) => d.severity === "WARN").length;
-        const message = `Schema validation failed: ${errorCount} error(s), ${warningCount} warning(s)`;
-        return new _SchemaValidationError(message, schemaId, diagnostics, source);
-      }
-      /**
-       * Create error for goneat binary not found
-       */
-      static goneatNotFound(goneatPath) {
-        const pathInfo = goneatPath ? ` at ${goneatPath}` : "";
-        return new _SchemaValidationError(
-          `Goneat binary not found${pathInfo}. Falling back to AJV validation.`
-        );
-      }
-      /**
-       * Create error for goneat execution failure
-       */
-      static goneatExecutionFailed(error) {
-        return new _SchemaValidationError(
-          "Goneat execution failed. Falling back to AJV validation.",
-          void 0,
-          [],
-          void 0,
-          error
-        );
-      }
-      /**
-       * Create error for empty schema input
-       */
-      static emptySchemaInput(source) {
-        return new _SchemaValidationError("Schema content is empty", void 0, [], source);
-      }
-      /**
-       * Create error for parse failure
-       */
-      static parseFailed(source, error) {
-        return new _SchemaValidationError(
-          `Failed to parse schema: ${error.message}`,
-          void 0,
-          [],
-          source,
-          error
-        );
-      }
-      /**
-       * Create error for encoding failure
-       */
-      static encodingFailed(source, error) {
-        return new _SchemaValidationError(
-          `Failed to encode schema: ${error.message}`,
-          void 0,
-          [],
-          source,
-          error
-        );
-      }
-      /**
-       * Create error for registry operation failure
-       */
-      static registryError(operation, details) {
-        return new _SchemaValidationError(`Schema registry ${operation} failed: ${details}`);
-      }
-      /**
-       * Format error for display
-       */
-      format() {
-        let output = this.message;
-        if (this.schemaId) {
-          output += `
-Schema ID: ${this.schemaId}`;
-        }
-        if (this.diagnostics.length > 0) {
-          output += "\n\nValidation Issues:";
-          this.diagnostics.forEach((diag, index) => {
-            output += `
-  ${index + 1}. [${diag.severity}] ${diag.message}`;
-            if (diag.pointer) {
-              output += ` at ${diag.pointer}`;
-            }
-            if (diag.keyword) {
-              output += ` (keyword: ${diag.keyword})`;
-            }
-            if (diag.source) {
-              output += ` [${diag.source}]`;
-            }
-          });
-        }
-        if (this.source) {
-          output += `
-
-Source: ${this.source.type}`;
-          if (this.source.id) {
-            output += ` (${this.source.id})`;
-          }
-        }
-        return output;
-      }
-      /**
-       * Convert to JSON representation
-       */
-      toJSON() {
-        return {
-          name: this.name,
-          message: this.message,
-          schemaId: this.schemaId,
-          diagnostics: this.diagnostics,
-          source: this.source,
-          cause: this.cause?.message
-        };
-      }
-    };
-  }
-});
-
-// src/schema/utils.ts
-var init_utils = __esm({
-  "src/schema/utils.ts"() {
-    init_errors();
-  }
-});
-var init_goneat_bridge = __esm({
-  "src/schema/goneat-bridge.ts"() {
-    init_utils();
-  }
-});
-var init_normalizer = __esm({
-  "src/schema/normalizer.ts"() {
-    init_errors();
-  }
-});
-function optionsChanged(newOptions) {
-  if (!globalRegistryOptions) return false;
-  return true;
-}
-function getSchemaRegistry(options) {
-  if (!globalRegistry || optionsChanged()) {
-    globalRegistry = new SchemaRegistry(options);
-    globalRegistryOptions = options;
-  }
-  return globalRegistry;
-}
-var DEFAULT_PATTERNS, SchemaRegistry, globalRegistry, globalRegistryOptions;
-var init_registry2 = __esm({
-  "src/schema/registry.ts"() {
-    init_errors();
-    DEFAULT_PATTERNS = ["**/*.schema.json", "**/*.schema.yaml", "**/*.schema.yml"];
-    SchemaRegistry = class {
-      schemas = /* @__PURE__ */ new Map();
-      options;
-      constructor(options = {}) {
-        this.options = {
-          baseDir: options.baseDir || this.getDefaultSchemaDir(),
-          patterns: options.patterns || DEFAULT_PATTERNS,
-          followSymlinks: options.followSymlinks ?? false,
-          maxDepth: options.maxDepth ?? 10
-        };
-      }
-      /**
-       * Get default schema directory using import.meta.url
-       */
-      getDefaultSchemaDir() {
-        const __filename = fileURLToPath(import.meta.url);
-        const __dirname2 = dirname(__filename);
-        return join(__dirname2, "..", "..", "schemas", "crucible-ts");
-      }
-      /**
-       * Build logical schema ID from file path
-       */
-      buildSchemaId(filePath, baseDir) {
-        const relativePath = relative(baseDir, filePath);
-        const withoutExt = relativePath.replace(/\.(schema\.(json|yaml|yml))$/, "");
-        return withoutExt.replace(/\\/g, "/");
-      }
-      /**
-       * Extract schema format from file extension
-       */
-      getSchemaFormat(filePath) {
-        const ext = extname(filePath).toLowerCase();
-        switch (ext) {
-          case ".json":
-            return "json";
-          case ".yaml":
-          case ".yml":
-            return "yaml";
-          default:
-            return "json";
-        }
-      }
-      /**
-       * Extract metadata from schema file
-       */
-      async extractMetadata(filePath) {
-        try {
-          const content = await readFile(filePath, "utf-8");
-          const format = this.getSchemaFormat(filePath);
-          let parsed;
-          if (format === "yaml") {
-            parsed = parse(content);
-          } else {
-            parsed = JSON.parse(content);
-          }
-          const baseDir = this.options.baseDir ?? "";
-          const relativePath = relative(baseDir, filePath);
-          return {
-            id: this.buildSchemaId(filePath, baseDir),
-            path: filePath,
-            relativePath,
-            format,
-            version: parsed.$schema || parsed.version,
-            description: parsed.title || parsed.description,
-            schemaDraft: parsed.$schema
-          };
-        } catch (error) {
-          throw SchemaValidationError.registryError(
-            "metadata extraction",
-            `Failed to process ${filePath}: ${error.message}`
-          );
-        }
-      }
-      /**
-       * Discover and index all available schemas
-       */
-      async discoverSchemas() {
-        try {
-          const baseDir = this.options.baseDir ?? "";
-          const patterns = this.options.patterns ?? [];
-          if (patterns.length === 0) {
-            this.schemas.clear();
-            return;
-          }
-          const pattern = patterns.map((p) => join(baseDir, p));
-          try {
-            await access(baseDir);
-          } catch {
-            this.schemas.clear();
-            return;
-          }
-          const files = await glob(pattern, {
-            absolute: true,
-            followSymbolicLinks: this.options.followSymlinks,
-            deep: this.options.maxDepth,
-            onlyFiles: true,
-            suppressErrors: true
-            // Don't throw on permission errors
-          });
-          this.schemas.clear();
-          for (const filePath of files) {
-            try {
-              const metadata = await this.extractMetadata(filePath);
-              this.schemas.set(metadata.id, metadata);
-            } catch (error) {
-              console.warn(`Warning: Failed to process schema ${filePath}:`, error);
-            }
-          }
-        } catch (error) {
-          throw SchemaValidationError.registryError("discovery", error.message);
-        }
-      }
-      /**
-       * List available schemas with optional prefix filtering
-       */
-      async listSchemas(prefix) {
-        if (this.schemas.size === 0) {
-          await this.discoverSchemas();
-        }
-        const schemas = Array.from(this.schemas.values());
-        if (prefix) {
-          return schemas.filter((schema) => schema.id.startsWith(prefix));
-        }
-        return schemas;
-      }
-      /**
-       * Get schema by logical ID
-       */
-      async getSchema(id) {
-        if (this.schemas.size === 0) {
-          await this.discoverSchemas();
-        }
-        const schema = this.schemas.get(id);
-        if (!schema) {
-          throw SchemaValidationError.schemaNotFound(id);
-        }
-        return schema;
-      }
-      /**
-       * Get schema by file path
-       */
-      async getSchemaByPath(filePath) {
-        if (this.schemas.size === 0) {
-          await this.discoverSchemas();
-        }
-        const absolutePath = filePath.startsWith("/") ? filePath : join(process.cwd(), filePath);
-        for (const schema of this.schemas.values()) {
-          if (schema.path === absolutePath) {
-            return schema;
-          }
-        }
-        throw SchemaValidationError.schemaNotFound(filePath);
-      }
-      /**
-       * Check if schema exists
-       */
-      async hasSchema(id) {
-        if (this.schemas.size === 0) {
-          await this.discoverSchemas();
-        }
-        return this.schemas.has(id);
-      }
-      /**
-       * Get registry size
-       */
-      get size() {
-        return this.schemas.size;
-      }
-      /**
-       * Clear registry cache
-       */
-      clear() {
-        this.schemas.clear();
-      }
-    };
-  }
-});
-async function loadMetaSchema(draft) {
-  const __filename = fileURLToPath(import.meta.url);
-  const __dirname2 = dirname(__filename);
-  const metaSchemaPath = join(
-    __dirname2,
-    "..",
-    "..",
-    "schemas",
-    "crucible-ts",
-    "meta",
-    draft,
-    "schema.json"
-  );
-  const content = await readFile(metaSchemaPath, "utf-8");
-  return JSON.parse(content);
-}
-async function loadVocabularySchemas(draft) {
-  if (draft !== "draft-2019-09" && draft !== "draft-2020-12") {
-    return [];
-  }
-  const __filename = fileURLToPath(import.meta.url);
-  const __dirname2 = dirname(__filename);
-  const vocabDir = join(__dirname2, "..", "..", "schemas", "crucible-ts", "meta", draft, "meta");
-  const vocabFiles = draft === "draft-2020-12" ? [
-    "core.json",
-    "applicator.json",
-    "unevaluated.json",
-    "validation.json",
-    "meta-data.json",
-    "format-annotation.json",
-    "content.json"
-  ] : [
-    "core.json",
-    "applicator.json",
-    "validation.json",
-    "meta-data.json",
-    "format.json",
-    "content.json"
-  ];
-  const schemas = [];
-  for (const file of vocabFiles) {
-    try {
-      const content = await readFile(join(vocabDir, file), "utf-8");
-      schemas.push(JSON.parse(content));
-    } catch {
-    }
-  }
-  return schemas;
-}
-async function loadReferencedSchema(uri) {
-  const __filename = fileURLToPath(import.meta.url);
-  const __dirname2 = dirname(__filename);
-  const repoRoot = join(__dirname2, "..", "..");
-  let resolvedPath;
-  if (uri.startsWith("https://schemas.fulmenhq.dev/")) {
-    let relativePath = uri.replace("https://schemas.fulmenhq.dev/", "");
-    if (relativePath.startsWith("crucible/")) {
-      relativePath = relativePath.slice("crucible/".length);
-    }
-    if (relativePath.startsWith("config/taxonomy/")) {
-      resolvedPath = join(
-        repoRoot,
-        "config",
-        "crucible-ts",
-        "taxonomy",
-        relativePath.split("/").pop() || ""
-      );
-    } else {
-      resolvedPath = join(repoRoot, "schemas", "crucible-ts", relativePath);
-    }
-  } else if (uri.startsWith("../../") || uri.startsWith("../")) {
-    const schemaBase = join(
-      repoRoot,
-      "schemas",
-      "crucible-ts",
-      "observability",
-      "metrics",
-      "v1.0.0"
-    );
-    resolvedPath = join(schemaBase, uri);
-  } else if (uri.startsWith("file://")) {
-    resolvedPath = fileURLToPath(uri);
-  } else {
-    throw new Error(`Cannot load remote schema: ${uri}`);
-  }
-  const content = await readFile(resolvedPath, "utf-8");
-  const ext = resolvedPath.split(".").pop()?.toLowerCase();
-  if (ext === "yaml" || ext === "yml") {
-    return parse(content);
-  }
-  return JSON.parse(content);
-}
-function detectDialect(schema) {
-  if (schema && typeof schema === "object" && !Array.isArray(schema)) {
-    const maybeSchema = schema;
-    const declared = maybeSchema.$schema;
-    if (typeof declared === "string") {
-      if (declared.includes("draft-04")) return "draft-04";
-      if (declared.includes("draft-06")) return "draft-06";
-      if (declared.includes("draft-07")) return "draft-07";
-      if (declared.includes("draft/2019-09")) return "draft-2019-09";
-      if (declared.includes("draft/2020-12")) return "draft-2020-12";
-    }
-  }
-  return "draft-2020-12";
-}
-function createAjv(dialect) {
-  const AjvCtor = dialect === "draft-2020-12" ? Ajv2020 : dialect === "draft-2019-09" ? Ajv2019 : dialect === "draft-04" ? AjvDraft04 : Ajv;
-  const ajv = new AjvCtor({
-    strict: false,
-    allErrors: true,
-    verbose: true,
-    // Allow schemas with $id to be added without replacing existing ones
-    addUsedSchema: false,
-    // draft-04 uses "id"; later drafts use "$id"
-    schemaId: dialect === "draft-04" ? "id" : "$id",
-    // Enable async schema loading for YAML references
-    loadSchema: loadReferencedSchema
-  });
-  applyFulmenAjvFormats(ajv);
-  return ajv;
-}
-async function getAjv(dialect) {
-  const existing = ajvInstances.get(dialect);
-  if (existing) {
-    const ready = metaschemaReady.get(dialect);
-    if (ready) await ready;
-    return existing;
-  }
-  const ajv = createAjv(dialect);
-  ajvInstances.set(dialect, ajv);
-  const readyPromise = Promise.all([loadVocabularySchemas(dialect), loadMetaSchema(dialect)]).then(([vocabSchemas, metaSchema]) => {
-    for (const vocabSchema of vocabSchemas) {
-      try {
-        ajv.addMetaSchema(vocabSchema);
-      } catch {
-      }
-    }
-    try {
-      ajv.addMetaSchema(metaSchema);
-    } catch {
-    }
-  }).catch((error) => {
-    throw new Error(`Failed to load metaschemas (${dialect}): ${error}`);
-  });
-  metaschemaReady.set(dialect, readyPromise);
-  await readyPromise;
-  return ajv;
-}
-async function compileSchema(schema, options = {}) {
-  const baseKey = typeof schema === "string" ? schema : JSON.stringify(schema);
-  let parsedSchema;
-  if (typeof schema === "string") {
-    try {
-      parsedSchema = JSON.parse(schema);
-    } catch {
-      parsedSchema = parse(schema);
-    }
-  } else if (Buffer.isBuffer(schema)) {
-    const content = schema.toString("utf-8");
-    try {
-      parsedSchema = JSON.parse(content);
-    } catch {
-      parsedSchema = parse(content);
-    }
-  } else {
-    parsedSchema = schema;
-  }
-  const dialect = detectDialect(parsedSchema);
-  const ajv = await getAjv(dialect);
-  const cacheKey = `${dialect}:${baseKey}`;
-  const cached = schemaCache.get(cacheKey);
-  if (cached !== void 0) {
-    return cached;
-  }
-  try {
-    if (options.aliases && options.aliases.length > 0) {
-      for (const alias of options.aliases) {
-        if (alias && ajv.getSchema(alias) === void 0) {
-          try {
-            if (typeof parsedSchema === "object" && parsedSchema !== null) {
-              ajv.addSchema(parsedSchema, alias);
-            }
-          } catch {
-          }
-        }
-      }
-    }
-    const validator = typeof parsedSchema === "boolean" ? ajv.compile(parsedSchema) : await ajv.compileAsync(parsedSchema);
-    schemaCache.set(cacheKey, validator);
-    return validator;
-  } catch (error) {
-    throw SchemaValidationError.parseFailed(
-      {
-        type: "string",
-        content: typeof schema === "string" ? schema : JSON.stringify(schema)
-      },
-      error
-    );
-  }
-}
-async function compileSchemaById(schemaId, registryOptions) {
-  try {
-    const registry = getSchemaRegistry(registryOptions);
-    const metadata = await registry.getSchema(schemaId);
-    const content = await readFile(metadata.path, "utf-8");
-    const aliases = [];
-    const normalizedRelativePath = metadata.relativePath.replace(/\\/g, "/");
-    if (normalizedRelativePath) {
-      aliases.push(
-        new URL(`crucible/${normalizedRelativePath}`, "https://schemas.fulmenhq.dev/").toString()
-      );
-    }
-    return compileSchema(content, { aliases });
-  } catch (error) {
-    metrics.counter("schema_validation_errors").inc();
-    throw error;
-  }
-}
-var ajvInstances, metaschemaReady, schemaCache;
-var init_validator = __esm({
-  "src/schema/validator.ts"() {
-    init_telemetry();
-    init_ajv_formats();
-    init_errors();
-    init_registry2();
-    init_utils();
-    ajvInstances = /* @__PURE__ */ new Map();
-    metaschemaReady = /* @__PURE__ */ new Map();
-    schemaCache = /* @__PURE__ */ new Map();
-  }
-});
-var init_cli = __esm({
-  "src/schema/cli.ts"() {
-    init_goneat_bridge();
-    init_normalizer();
-    init_registry2();
-    init_utils();
-    init_validator();
-  }
-});
-var init_export = __esm({
-  "src/schema/export.ts"() {
-    init_errors();
-    init_registry2();
-    init_validator();
-  }
-});
-
-// src/schema/index.ts
-var init_schema = __esm({
-  "src/schema/index.ts"() {
-    init_ajv_formats();
-    init_cli();
-    init_errors();
-    init_export();
-    init_goneat_bridge();
-    init_normalizer();
-    init_registry2();
-    init_utils();
-    init_validator();
-  }
-});
-
-// src/telemetry/validators.ts
-async function validateMetricsEvent(event) {
-  return MetricsValidator.getInstance().validate(event);
-}
-async function validateMetricsEvents(events) {
-  for (const event of events) {
-    if (!await validateMetricsEvent(event)) {
-      return false;
-    }
-  }
-  return true;
-}
-function getValidationErrors() {
-  return MetricsValidator.getInstance().getErrors();
-}
-function formatValidationErrors(errors) {
-  return errors.map((err) => {
-    const path = err.instancePath || "(root)";
-    const message = err.message || "validation failed";
-    return `${path}: ${message}`;
-  }).join("; ");
-}
-async function assertValidMetricsEvent(event) {
-  if (!await validateMetricsEvent(event)) {
-    const errors = getValidationErrors();
-    const message = errors ? formatValidationErrors(errors) : "Metrics event validation failed";
-    throw new Error(`Invalid metrics event: ${message}`);
-  }
-}
-var MetricsValidator;
-var init_validators = __esm({
-  "src/telemetry/validators.ts"() {
-    init_schema();
-    MetricsValidator = class _MetricsValidator {
-      static instance;
-      validateFn = null;
-      initPromise = null;
-      initError = null;
-      constructor() {
-      }
-      /**
-       * Get singleton instance
-       */
-      static getInstance() {
-        if (!_MetricsValidator.instance) {
-          _MetricsValidator.instance = new _MetricsValidator();
-        }
-        return _MetricsValidator.instance;
-      }
-      /**
-       * Initialize validator (lazy load, async)
-       */
-      async init() {
-        if (this.validateFn !== null || this.initError !== null) {
-          return;
-        }
-        if (this.initPromise) {
-          return this.initPromise;
-        }
-        this.initPromise = (async () => {
-          try {
-            this.validateFn = await compileSchemaById("observability/metrics/v1.0.0/metrics-event");
-          } catch (err) {
-            this.initError = err instanceof Error ? err : new Error(String(err));
-            throw new Error(`Failed to initialize metrics validator: ${this.initError.message}`);
-          }
-        })();
-        return this.initPromise;
-      }
-      /**
-       * Validate metrics event against schema
-       *
-       * @param event - Metrics event to validate
-       * @returns Promise resolving to true if valid, false otherwise
-       */
-      async validate(event) {
-        if (this.validateFn === null) {
-          await this.init();
-        }
-        if (this.initError) {
-          throw this.initError;
-        }
-        if (!this.validateFn) {
-          throw new Error("Validator not initialized");
-        }
-        return this.validateFn(event);
-      }
-      /**
-       * Get validation errors from last validation
-       */
-      getErrors() {
-        if (!this.validateFn) {
-          return null;
-        }
-        return this.validateFn.errors;
-      }
-      /**
-       * Reset validator state (for testing)
-       * @internal
-       */
-      static _reset() {
-        _MetricsValidator.instance = new _MetricsValidator();
-      }
-    };
-  }
-});
-
-// src/telemetry/index.ts
-var VERSION, metrics;
-var init_telemetry = __esm({
-  "src/telemetry/index.ts"() {
-    init_registry();
-    init_registry();
-    init_counter();
-    init_gauge();
-    init_histogram();
-    init_taxonomy();
-    init_types();
-    init_validators();
-    VERSION = "1.0.0";
-    metrics = new MetricsRegistry();
-  }
-});
-init_telemetry();
-
-export { Counter, DEFAULT_MS_BUCKETS, Gauge, Histogram, MetricsRegistry, VERSION, assertValidMetricsEvent, formatValidationErrors, getDefaultBuckets, getDefaultUnit, getMetric, getTaxonomy, getValidationErrors, isHistogramSummary, isValidMetricName2 as isValidMetricName, isValidMetricName as isValidMetricNameTaxonomy, isValidMetricUnit, metrics, validateMetricsEvent, validateMetricsEvents };
+export { Counter, DEFAULT_MS_BUCKETS, Gauge, Histogram, MetricsRegistry, VERSION, assertValidMetricsEvent, formatValidationErrors, getDefaultBuckets, getDefaultUnit, getMetric, getTaxonomy, getValidationErrors, isHistogramSummary, isValidMetricName2 as isValidMetricName, isValidMetricName as isValidMetricNameTaxonomy, isValidMetricUnit, metrics, validateMetricsEvent, validateMetricsEvents } from '../chunk-7SVYOPJ3.js';
+import '../chunk-QCCN6POA.js';
+import '../chunk-BTUS6PZZ.js';
+import '../chunk-UP2VWCW5.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map