@fulmenhq/tsfulmen 0.3.2 → 0.4.0

package/dist/config/index.js

@@ -1,1220 +1,12 @@
-import addFormats from 'ajv-formats';
-import 'child_process';
-import { readFile, access, mkdir } from 'fs/promises';
+import { metrics, compileSchema, validateData } from '../chunk-7SVYOPJ3.js';
+import '../chunk-QCCN6POA.js';
+import '../chunk-BTUS6PZZ.js';
+import '../chunk-UP2VWCW5.js';
+import { access, mkdir, readFile } from 'fs/promises';
+import { join, isAbsolute, resolve, extname } from 'path';
 import { parse } from 'yaml';
-import { join, isAbsolute, resolve, extname, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import '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';
 import { homedir } from 'os';
 
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __esm = (fn, res) => function __init() {
-  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
-};
-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
-function createDiagnostic(pointer, message, keyword, severity = "ERROR", source = "ajv", data) {
-  return {
-    pointer,
-    message,
-    keyword,
-    severity,
-    source,
-    data
-  };
-}
-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();
-  }
-});
-var init_registry = __esm({
-  "src/schema/registry.ts"() {
-    init_errors();
-  }
-});
-
-// 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 getDefaultUnit(name) {
-  return TaxonomyLoader.getInstance().getDefaultUnit(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_registry2 = __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
-var init_types = __esm({
-  "src/telemetry/types.ts"() {
-  }
-});
-
-// src/telemetry/validators.ts
-var init_validators = __esm({
-  "src/telemetry/validators.ts"() {
-    init_schema();
-  }
-});
-
-// src/telemetry/index.ts
-var metrics;
-var init_telemetry = __esm({
-  "src/telemetry/index.ts"() {
-    init_registry2();
-    init_registry2();
-    init_counter();
-    init_gauge();
-    init_histogram();
-    init_taxonomy();
-    init_types();
-    init_validators();
-    metrics = new MetricsRegistry();
-  }
-});
-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
-    );
-  }
-}
-function validateData(data, validator) {
-  const valid = validator(data);
-  const result = {
-    valid,
-    diagnostics: [],
-    source: "ajv"
-  };
-  if (!valid && validator.errors) {
-    const errors = validator.errors;
-    if (Array.isArray(errors)) {
-      result.diagnostics = errors.map(
-        (error) => createDiagnostic(
-          error.instancePath || "",
-          error.message || "Validation failed",
-          error.keyword || "unknown",
-          "ERROR",
-          "ajv"
-        )
-      );
-    }
-    metrics.counter("schema_validation_errors").inc();
-  } else {
-    metrics.counter("schema_validations").inc();
-  }
-  return result;
-}
-var ajvInstances, metaschemaReady, schemaCache;
-var init_validator = __esm({
-  "src/schema/validator.ts"() {
-    init_telemetry();
-    init_ajv_formats();
-    init_errors();
-    init_registry();
-    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_registry();
-    init_utils();
-    init_validator();
-  }
-});
-var init_export = __esm({
-  "src/schema/export.ts"() {
-    init_errors();
-    init_registry();
-    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_registry();
-    init_utils();
-    init_validator();
-  }
-});
-
 // src/config/env-alias.ts
 function resolveEnvAliases(env, aliasToCanonical) {
   const out = { ...env };
@@ -1301,12 +93,6 @@ var ConfigValidationError = class _ConfigValidationError extends Error {
     }
   }
 };
-
-// src/config/loader.ts
-init_schema();
-
-// src/config/paths.ts
-init_telemetry();
 function getPlatformInfo() {
   const osPlatform = process.platform;
   const homeDir = homedir();
@@ -1631,9 +417,16 @@ async function parseConfigFile(path) {
   throw new Error(`Unsupported config file extension: ${ext}`);
 }
 async function loadConfig(options) {
-  const { identity, defaultsPath, userConfigName } = options;
+  const { identity, defaultsPath, defaults, userConfigName } = options;
   const activeLayers = ["defaults"];
-  let mergedConfig = await parseConfigFile(defaultsPath);
+  let mergedConfig;
+  if (defaults !== void 0) {
+    mergedConfig = structuredClone(defaults);
+  } else if (defaultsPath) {
+    mergedConfig = await parseConfigFile(defaultsPath);
+  } else {
+    throw new Error("loadConfig requires either `defaults` (inline) or `defaultsPath`");
+  }
   const configName = userConfigName || identity.app;
   const extensions = [".yaml", ".yml", ".json"];
   let userConfigPath = null;
@@ -1659,9 +452,10 @@ async function loadConfig(options) {
     mergedConfig = deepMerge(mergedConfig, envConfig);
     activeLayers.push("env");
   }
-  if (options.schemaPath) {
+  const schemaProvided = options.schema !== void 0 || options.schemaPath !== void 0;
+  if (schemaProvided) {
     try {
-      const schemaContent = await readFile(options.schemaPath, "utf-8");
+      const schemaContent = options.schema !== void 0 ? options.schema : await readFile(options.schemaPath, "utf-8");
       const validator = await compileSchema(schemaContent);
       const result = validateData(mergedConfig, validator);
       if (!result.valid) {
@@ -1681,15 +475,18 @@ async function loadConfig(options) {
   return {
     config: mergedConfig,
     metadata: {
-      defaultsPath,
+      defaultsPath: defaults !== void 0 ? "" : defaultsPath,
+      defaultsSource: defaults !== void 0 ? "inline" : "path",
       userConfigPath,
       envPrefix,
       envVarsConsumed: includeEnvVarReport ? envVars?.consumedKeys : void 0,
       envVarsConsumedCount: includeEnvVarReport ? envVars?.consumedKeys.length : void 0,
       activeLayers,
       schema: {
-        path: options.schemaPath || null,
-        validated: !!options.schemaPath
+        // Inline schema wins over schemaPath, and has no backing file → report null.
+        path: options.schema !== void 0 ? null : options.schemaPath ?? null,
+        source: options.schema !== void 0 ? "inline" : options.schemaPath ? "path" : null,
+        validated: schemaProvided
       }
     }
   };