@dotsetlabs/bellwether 1.0.3 → 2.0.0

package/dist/config/validator.js

@@ -13,7 +13,8 @@ import { getExternalServiceStatus } from '../baseline/external-dependency-detect
 /**
  * Server configuration schema.
  */
-export const serverConfigSchema = z.object({
+export const serverConfigSchema = z
+    .object({
     /** Command to start the MCP server */
     command: z.string().default(CONFIG_DEFAULTS.server.command),
     /** Arguments to pass to the server command */
@@ -26,25 +27,31 @@ export const serverConfigSchema = z.object({
         .max(VALIDATION_BOUNDS.TIMEOUT.MAX_MS)
         .default(CONFIG_DEFAULTS.server.timeout),
     /** Transport type */
-    transport: z.enum(['stdio', 'sse', 'streamable-http']).default(CONFIG_DEFAULTS.server.transport),
+    transport: z
+        .enum(['stdio', 'sse', 'streamable-http'])
+        .default(CONFIG_DEFAULTS.server.transport),
     /** Remote MCP server URL (required for sse/streamable-http) */
     url: z.string().optional().default(CONFIG_DEFAULTS.server.url),
     /** Session ID for remote auth */
     sessionId: z.string().optional().default(CONFIG_DEFAULTS.server.sessionId),
     /** Additional environment variables */
     env: z.record(z.string()).optional(),
-}).default(CONFIG_DEFAULTS.server);
+})
+    .default(CONFIG_DEFAULTS.server);
 /**
  * LLM Ollama-specific settings.
  */
-export const ollamaConfigSchema = z.object({
+export const ollamaConfigSchema = z
+    .object({
     /** Ollama server base URL */
     baseUrl: z.string().url().default(CONFIG_DEFAULTS.llm.ollama.baseUrl),
-}).default(CONFIG_DEFAULTS.llm.ollama);
+})
+    .default(CONFIG_DEFAULTS.llm.ollama);
 /**
  * LLM configuration schema.
  */
-export const llmConfigSchema = z.object({
+export const llmConfigSchema = z
+    .object({
     /** LLM provider */
     provider: z.enum(['ollama', 'openai', 'anthropic']).default(CONFIG_DEFAULTS.llm.provider),
     /** Model to use (empty = provider default) */
@@ -55,18 +62,17 @@ export const llmConfigSchema = z.object({
     openaiApiKeyEnvVar: z.string().optional(),
     /** Environment variable for Anthropic API key */
     anthropicApiKeyEnvVar: z.string().optional(),
-}).default(CONFIG_DEFAULTS.llm);
+})
+    .default(CONFIG_DEFAULTS.llm);
 /**
  * Explore configuration schema (for bellwether explore command).
  */
-export const exploreConfigSchema = z.object({
+export const exploreConfigSchema = z
+    .object({
     /** Personas to use for exploration */
-    personas: z.array(z.enum([
-        'technical_writer',
-        'security_tester',
-        'qa_engineer',
-        'novice_user',
-    ])).default([...CONFIG_DEFAULTS.explore.personas]),
+    personas: z
+        .array(z.enum(['technical_writer', 'security_tester', 'qa_engineer', 'novice_user']))
+        .default([...CONFIG_DEFAULTS.explore.personas]),
     /** Maximum questions per tool */
     maxQuestionsPerTool: z
         .number()
@@ -85,7 +91,8 @@ export const exploreConfigSchema = z.object({
         .default(CONFIG_DEFAULTS.explore.personaConcurrency),
     /** Skip error/edge case testing */
     skipErrorTests: z.boolean().default(CONFIG_DEFAULTS.explore.skipErrorTests),
-}).default(() => ({
+})
+    .default(() => ({
     personas: [...CONFIG_DEFAULTS.explore.personas],
     maxQuestionsPerTool: CONFIG_DEFAULTS.explore.maxQuestionsPerTool,
     parallelPersonas: CONFIG_DEFAULTS.explore.parallelPersonas,
@@ -95,16 +102,19 @@ export const exploreConfigSchema = z.object({
 /**
  * Scenarios configuration schema.
  */
-export const scenariosConfigSchema = z.object({
+export const scenariosConfigSchema = z
+    .object({
     /** Path to scenarios YAML file */
     path: z.string().optional(),
     /** Run only scenarios (no LLM tests) */
     only: z.boolean().default(CONFIG_DEFAULTS.scenarios.only),
-}).default(CONFIG_DEFAULTS.scenarios);
+})
+    .default(CONFIG_DEFAULTS.scenarios);
 /**
  * Workflows configuration schema.
  */
-export const workflowsConfigSchema = z.object({
+export const workflowsConfigSchema = z
+    .object({
     /** Path to workflows YAML file */
     path: z.string().optional(),
     /** Enable LLM-based workflow discovery */
@@ -114,33 +124,76 @@ export const workflowsConfigSchema = z.object({
     /** Auto-generate workflows from discovered tools */
     autoGenerate: z.boolean().default(CONFIG_DEFAULTS.workflows.autoGenerate),
     /** Skip steps whose dependencies (previous steps providing data) have failed */
-    requireSuccessfulDependencies: z.boolean().default(CONFIG_DEFAULTS.workflows.requireSuccessfulDependencies),
+    requireSuccessfulDependencies: z
+        .boolean()
+        .default(CONFIG_DEFAULTS.workflows.requireSuccessfulDependencies),
     /** Timeout per workflow step in milliseconds */
-    stepTimeout: z.number().int().min(1000).max(300000).default(CONFIG_DEFAULTS.workflows.stepTimeout),
+    stepTimeout: z
+        .number()
+        .int()
+        .min(1000)
+        .max(300000)
+        .default(CONFIG_DEFAULTS.workflows.stepTimeout),
     /** Timeout configuration for workflow operations */
-    timeouts: z.object({
-        toolCall: z.number().int().min(1000).max(300000).default(CONFIG_DEFAULTS.workflows.timeouts.toolCall),
-        stateSnapshot: z.number().int().min(1000).max(300000).default(CONFIG_DEFAULTS.workflows.timeouts.stateSnapshot),
-        probeTool: z.number().int().min(1000).max(300000).default(CONFIG_DEFAULTS.workflows.timeouts.probeTool),
-        llmAnalysis: z.number().int().min(1000).max(300000).default(CONFIG_DEFAULTS.workflows.timeouts.llmAnalysis),
-        llmSummary: z.number().int().min(1000).max(300000).default(CONFIG_DEFAULTS.workflows.timeouts.llmSummary),
-    }).default(CONFIG_DEFAULTS.workflows.timeouts),
-}).default(CONFIG_DEFAULTS.workflows);
+    timeouts: z
+        .object({
+        toolCall: z
+            .number()
+            .int()
+            .min(1000)
+            .max(300000)
+            .default(CONFIG_DEFAULTS.workflows.timeouts.toolCall),
+        stateSnapshot: z
+            .number()
+            .int()
+            .min(1000)
+            .max(300000)
+            .default(CONFIG_DEFAULTS.workflows.timeouts.stateSnapshot),
+        probeTool: z
+            .number()
+            .int()
+            .min(1000)
+            .max(300000)
+            .default(CONFIG_DEFAULTS.workflows.timeouts.probeTool),
+        llmAnalysis: z
+            .number()
+            .int()
+            .min(1000)
+            .max(300000)
+            .default(CONFIG_DEFAULTS.workflows.timeouts.llmAnalysis),
+        llmSummary: z
+            .number()
+            .int()
+            .min(1000)
+            .max(300000)
+            .default(CONFIG_DEFAULTS.workflows.timeouts.llmSummary),
+    })
+        .default(CONFIG_DEFAULTS.workflows.timeouts),
+})
+    .default(CONFIG_DEFAULTS.workflows);
 /**
  * Example output configuration schema.
  */
-export const examplesConfigSchema = z.object({
+export const examplesConfigSchema = z
+    .object({
     /** Include full (non-truncated) examples */
     full: z.boolean().default(CONFIG_DEFAULTS.output.examples.full),
     /** Maximum example length in characters */
-    maxLength: z.number().int().min(100).max(50000).default(CONFIG_DEFAULTS.output.examples.maxLength),
+    maxLength: z
+        .number()
+        .int()
+        .min(100)
+        .max(50000)
+        .default(CONFIG_DEFAULTS.output.examples.maxLength),
     /** Maximum examples per tool */
     maxPerTool: z.number().int().min(1).max(20).default(CONFIG_DEFAULTS.output.examples.maxPerTool),
-}).default(CONFIG_DEFAULTS.output.examples);
+})
+    .default(CONFIG_DEFAULTS.output.examples);
 /**
  * Output file name configuration schema.
  */
-export const outputFilesConfigSchema = z.object({
+export const outputFilesConfigSchema = z
+    .object({
     /** Check report JSON file name */
     checkReport: z.string().default(CONFIG_DEFAULTS.output.files.checkReport),
     /** Explore report JSON file name */
@@ -149,22 +202,38 @@ export const outputFilesConfigSchema = z.object({
     contractDoc: z.string().default(CONFIG_DEFAULTS.output.files.contractDoc),
     /** Agents documentation file name */
     agentsDoc: z.string().default(CONFIG_DEFAULTS.output.files.agentsDoc),
-}).default(CONFIG_DEFAULTS.output.files);
+})
+    .default(CONFIG_DEFAULTS.output.files);
+/**
+ * Output format schema.
+ * Accepts legacy values (agents.md) and synonyms (docs, markdown) and normalizes to "docs".
+ */
+const outputFormatSchema = z.preprocess((value) => {
+    if (typeof value === 'string') {
+        const normalized = value.trim().toLowerCase();
+        if (normalized === 'agents.md' || normalized === 'markdown' || normalized === 'docs') {
+            return 'docs';
+        }
+    }
+    return value;
+}, z.enum(['docs', 'json', 'both']));
 /**
  * Output configuration schema.
  */
-export const outputConfigSchema = z.object({
+export const outputConfigSchema = z
+    .object({
     /** Output directory for JSON files (bellwether-check.json, etc.) */
     dir: z.string().default(CONFIG_DEFAULTS.output.dir),
     /** Output directory for documentation files (CONTRACT.md, AGENTS.md) */
     docsDir: z.string().default(CONFIG_DEFAULTS.output.docsDir),
     /** Output format */
-    format: z.enum(['agents.md', 'json', 'both']).default(CONFIG_DEFAULTS.output.format),
+    format: outputFormatSchema.default(CONFIG_DEFAULTS.output.format),
     /** Example output settings */
     examples: examplesConfigSchema,
     /** Output file names */
     files: outputFilesConfigSchema,
-}).default(CONFIG_DEFAULTS.output);
+})
+    .default(CONFIG_DEFAULTS.output);
 /**
  * Severity levels for configuration.
  */
@@ -175,70 +244,96 @@ const severityLevels = ['none', 'info', 'warning', 'breaking'];
 const behaviorAspects = [
     'response_format',
     'response_structure',
+    'response_schema_evolution',
     'error_handling',
     'error_pattern',
     'security',
     'performance',
     'schema',
     'description',
+    'prompt',
+    'resource',
+    'server',
+    'capability',
 ];
 /**
  * Severity configuration schema.
  * Allows customizing how changes are classified and reported.
  */
-export const severityConfigSchema = z.object({
+export const severityConfigSchema = z
+    .object({
     /** Minimum severity level to include in reports */
-    minimumSeverity: z.enum(severityLevels).default(CONFIG_DEFAULTS.baseline.severity.minimumSeverity),
+    minimumSeverity: z
+        .enum(severityLevels)
+        .default(CONFIG_DEFAULTS.baseline.severity.minimumSeverity),
     /** Severity level at which to fail CI checks */
-    failOnSeverity: z.enum(severityLevels).default(CONFIG_DEFAULTS.baseline.severity.failOnSeverity),
+    failOnSeverity: z
+        .enum(severityLevels)
+        .default(CONFIG_DEFAULTS.baseline.severity.failOnSeverity),
     /** Suppress warning-level changes from output */
     suppressWarnings: z.boolean().default(CONFIG_DEFAULTS.baseline.severity.suppressWarnings),
     /** Custom severity overrides per aspect */
     aspectOverrides: z.record(z.enum(behaviorAspects), z.enum(severityLevels)).optional(),
-}).default(CONFIG_DEFAULTS.baseline.severity);
+})
+    .default(CONFIG_DEFAULTS.baseline.severity);
 /**
  * Security testing configuration schema.
  */
-export const securityConfigSchema = z.object({
+export const securityConfigSchema = z
+    .object({
     /** Enable security vulnerability testing */
     enabled: z.boolean().default(CONFIG_DEFAULTS.check.security.enabled),
     /** Security categories to test */
-    categories: z.array(z.enum([
+    categories: z
+        .array(z.enum([
         'sql_injection',
         'xss',
         'path_traversal',
         'command_injection',
         'ssrf',
         'error_disclosure',
-    ])).default([...CONFIG_DEFAULTS.check.security.categories]),
-}).default(() => ({
+    ]))
+        .default([...CONFIG_DEFAULTS.check.security.categories]),
+})
+    .default(() => ({
     enabled: CONFIG_DEFAULTS.check.security.enabled,
     categories: [...CONFIG_DEFAULTS.check.security.categories],
 }));
 /**
  * Statistical sampling configuration schema.
  */
-export const samplingConfigSchema = z.object({
+export const samplingConfigSchema = z
+    .object({
     /** Minimum samples per tool for statistical confidence */
     minSamples: z.number().int().min(1).max(50).default(CONFIG_DEFAULTS.check.sampling.minSamples),
     /** Target confidence level */
-    targetConfidence: z.enum(['low', 'medium', 'high']).default(CONFIG_DEFAULTS.check.sampling.targetConfidence),
+    targetConfidence: z
+        .enum(['low', 'medium', 'high'])
+        .default(CONFIG_DEFAULTS.check.sampling.targetConfidence),
     /** Fail if confidence is below target */
     failOnLowConfidence: z.boolean().default(CONFIG_DEFAULTS.check.sampling.failOnLowConfidence),
-}).default(CONFIG_DEFAULTS.check.sampling);
+})
+    .default(CONFIG_DEFAULTS.check.sampling);
 /**
  * Metrics configuration schema.
  */
-export const metricsConfigSchema = z.object({
+export const metricsConfigSchema = z
+    .object({
     /** Count validation rejections as success */
-    countValidationAsSuccess: z.boolean().default(CONFIG_DEFAULTS.check.metrics.countValidationAsSuccess),
+    countValidationAsSuccess: z
+        .boolean()
+        .default(CONFIG_DEFAULTS.check.metrics.countValidationAsSuccess),
     /** Separate validation metrics from reliability metrics */
-    separateValidationMetrics: z.boolean().default(CONFIG_DEFAULTS.check.metrics.separateValidationMetrics),
-}).default(CONFIG_DEFAULTS.check.metrics);
+    separateValidationMetrics: z
+        .boolean()
+        .default(CONFIG_DEFAULTS.check.metrics.separateValidationMetrics),
+})
+    .default(CONFIG_DEFAULTS.check.metrics);
 /**
  * Stateful testing configuration schema.
  */
-export const statefulTestingConfigSchema = z.object({
+export const statefulTestingConfigSchema = z
+    .object({
     /** Enable stateful tool testing */
     enabled: z.boolean().default(CONFIG_DEFAULTS.check.statefulTesting.enabled),
     /** Maximum dependency chain length */
@@ -249,8 +344,11 @@ export const statefulTestingConfigSchema = z.object({
         .max(VALIDATION_BOUNDS.STATEFUL_CHAIN.MAX)
         .default(CONFIG_DEFAULTS.check.statefulTesting.maxChainLength),
     /** Share outputs between dependent tools */
-    shareOutputsBetweenTools: z.boolean().default(CONFIG_DEFAULTS.check.statefulTesting.shareOutputsBetweenTools),
-}).default(CONFIG_DEFAULTS.check.statefulTesting);
+    shareOutputsBetweenTools: z
+        .boolean()
+        .default(CONFIG_DEFAULTS.check.statefulTesting.shareOutputsBetweenTools),
+})
+    .default(CONFIG_DEFAULTS.check.statefulTesting);
 /**
  * External service configuration schema.
  */
@@ -263,27 +361,32 @@ export const externalServiceConfigSchema = z.object({
 /**
  * External services handling configuration schema.
  */
-export const externalServicesConfigSchema = z.object({
+export const externalServicesConfigSchema = z
+    .object({
     /** Mode for unconfigured services */
     mode: z.enum(['skip', 'mock', 'fail']).default(CONFIG_DEFAULTS.check.externalServices.mode),
     /** Per-service configuration overrides */
     services: z.record(externalServiceConfigSchema).optional(),
-}).default(CONFIG_DEFAULTS.check.externalServices);
+})
+    .default(CONFIG_DEFAULTS.check.externalServices);
 /**
  * Response assertion configuration schema.
  */
-export const assertionsConfigSchema = z.object({
+export const assertionsConfigSchema = z
+    .object({
     /** Enable response assertions */
     enabled: z.boolean().default(CONFIG_DEFAULTS.check.assertions.enabled),
     /** Strict mode fails on assertion violations */
     strict: z.boolean().default(CONFIG_DEFAULTS.check.assertions.strict),
     /** Infer schemas from responses */
     infer: z.boolean().default(CONFIG_DEFAULTS.check.assertions.infer),
-}).default(CONFIG_DEFAULTS.check.assertions);
+})
+    .default(CONFIG_DEFAULTS.check.assertions);
 /**
  * Rate limiting configuration schema.
  */
-export const rateLimitConfigSchema = z.object({
+export const rateLimitConfigSchema = z
+    .object({
     /** Enable rate limiting */
     enabled: z.boolean().default(CONFIG_DEFAULTS.check.rateLimit.enabled),
     /** Requests per second */
@@ -300,7 +403,9 @@ export const rateLimitConfigSchema = z.object({
         .max(VALIDATION_BOUNDS.RATE_LIMIT.BURST_LIMIT.MAX)
         .default(CONFIG_DEFAULTS.check.rateLimit.burstLimit),
     /** Backoff strategy */
-    backoffStrategy: z.enum(['linear', 'exponential']).default(CONFIG_DEFAULTS.check.rateLimit.backoffStrategy),
+    backoffStrategy: z
+        .enum(['linear', 'exponential'])
+        .default(CONFIG_DEFAULTS.check.rateLimit.backoffStrategy),
     /** Maximum retries on rate limit */
     maxRetries: z
         .number()
@@ -308,7 +413,8 @@ export const rateLimitConfigSchema = z.object({
         .min(VALIDATION_BOUNDS.RATE_LIMIT.MAX_RETRIES.MIN)
         .max(VALIDATION_BOUNDS.RATE_LIMIT.MAX_RETRIES.MAX)
         .default(CONFIG_DEFAULTS.check.rateLimit.maxRetries),
-}).default(CONFIG_DEFAULTS.check.rateLimit);
+})
+    .default(CONFIG_DEFAULTS.check.rateLimit);
 /**
  * Test fixture pattern schema.
  * Allows matching parameter names by regex pattern.
@@ -323,29 +429,43 @@ export const testFixturePatternSchema = z.object({
  * Test fixtures configuration schema.
  * Allows users to customize test values for production server testing.
  */
-export const testFixturesConfigSchema = z.object({
+export const testFixturesConfigSchema = z
+    .object({
     /** Custom values for specific parameter names (exact match) */
     parameterValues: z.record(z.unknown()).optional(),
     /** Custom values for parameters matching regex patterns */
     patterns: z.array(testFixturePatternSchema).optional(),
-}).optional();
+})
+    .optional();
 /**
  * Check command configuration schema.
  * Controls behavior of `bellwether check`.
  */
-export const checkConfigSchema = z.object({
+export const checkConfigSchema = z
+    .object({
     /** Enable incremental checking (only test tools with changed schemas) */
     incremental: z.boolean().default(CONFIG_DEFAULTS.check.incremental),
     /** Maximum age of cached results in hours (for incremental checking) */
-    incrementalCacheHours: z.number().int().min(1).max(720).default(CONFIG_DEFAULTS.check.incrementalCacheHours),
+    incrementalCacheHours: z
+        .number()
+        .int()
+        .min(1)
+        .max(720)
+        .default(CONFIG_DEFAULTS.check.incrementalCacheHours),
     /** Enable parallel tool testing (faster checks) */
     parallel: z.boolean().default(CONFIG_DEFAULTS.check.parallel),
     /** Number of concurrent tool workers (1-10) */
     parallelWorkers: z.number().int().min(1).max(10).default(CONFIG_DEFAULTS.check.parallelWorkers),
     /** Performance regression threshold percentage (0-100, e.g., 25 = 25% slower triggers warning) */
-    performanceThreshold: z.number().min(0).max(100).default(CONFIG_DEFAULTS.check.performanceThreshold),
+    performanceThreshold: z
+        .number()
+        .min(0)
+        .max(100)
+        .default(CONFIG_DEFAULTS.check.performanceThreshold),
     /** Default diff output format */
-    diffFormat: z.enum(['text', 'json', 'compact', 'github', 'markdown', 'junit', 'sarif']).default(CONFIG_DEFAULTS.check.diffFormat),
+    diffFormat: z
+        .enum(['text', 'json', 'compact', 'github', 'markdown', 'junit', 'sarif'])
+        .default(CONFIG_DEFAULTS.check.diffFormat),
     /** Number of warmup runs before timing samples (excluded from variance calculation) */
     warmupRuns: z.number().int().min(0).max(5).default(CONFIG_DEFAULTS.check.warmupRuns),
     /** Enable smart test value generation from schema descriptions (e.g., YYYY-MM-DD dates) */
@@ -366,7 +486,8 @@ export const checkConfigSchema = z.object({
     sampling: samplingConfigSchema,
     /** Test fixtures for production server testing */
     testFixtures: testFixturesConfigSchema,
-}).default(() => ({
+})
+    .default(() => ({
     incremental: CONFIG_DEFAULTS.check.incremental,
     incrementalCacheHours: CONFIG_DEFAULTS.check.incrementalCacheHours,
     parallel: CONFIG_DEFAULTS.check.parallel,
@@ -389,7 +510,8 @@ export const checkConfigSchema = z.object({
 /**
  * Baseline configuration schema.
  */
-export const baselineConfigSchema = z.object({
+export const baselineConfigSchema = z
+    .object({
     /** Default baseline file path (relative to output.dir or absolute) */
     path: z.string().default(CONFIG_DEFAULTS.baseline.path),
     /** Path to save baseline after check (enables auto-save) */
@@ -399,32 +521,42 @@ export const baselineConfigSchema = z.object({
     /** Fail if drift is detected */
     failOnDrift: z.boolean().default(CONFIG_DEFAULTS.baseline.failOnDrift),
     /** Default output format for baseline comparisons */
-    outputFormat: z.enum(['text', 'json', 'markdown', 'compact']).default(CONFIG_DEFAULTS.baseline.outputFormat),
+    outputFormat: z
+        .enum(['text', 'json', 'markdown', 'compact'])
+        .default(CONFIG_DEFAULTS.baseline.outputFormat),
     /** Severity thresholds for filtering and CI failure */
     severity: severityConfigSchema,
-}).default(CONFIG_DEFAULTS.baseline);
+})
+    .default(CONFIG_DEFAULTS.baseline);
 /**
  * Cache configuration schema.
  */
-export const cacheConfigSchema = z.object({
+export const cacheConfigSchema = z
+    .object({
     /** Enable response caching */
     enabled: z.boolean().default(CONFIG_DEFAULTS.cache.enabled),
     /** Cache directory */
     dir: z.string().default(CONFIG_DEFAULTS.cache.dir),
-}).default(CONFIG_DEFAULTS.cache);
+})
+    .default(CONFIG_DEFAULTS.cache);
 /**
  * Logging configuration schema.
  */
-export const loggingConfigSchema = z.object({
+export const loggingConfigSchema = z
+    .object({
     /** Log level */
-    level: z.enum(['debug', 'info', 'warn', 'error', 'silent']).default(CONFIG_DEFAULTS.logging.level),
+    level: z
+        .enum(['debug', 'info', 'warn', 'error', 'silent'])
+        .default(CONFIG_DEFAULTS.logging.level),
     /** Verbose output */
     verbose: z.boolean().default(CONFIG_DEFAULTS.logging.verbose),
-}).default(CONFIG_DEFAULTS.logging);
+})
+    .default(CONFIG_DEFAULTS.logging);
 /**
  * Watch mode configuration schema.
  */
-export const watchConfigSchema = z.object({
+export const watchConfigSchema = z
+    .object({
     /** Path to watch for changes */
     path: z.string().default(CONFIG_DEFAULTS.watch.path),
     /** Polling interval in milliseconds */
@@ -433,7 +565,8 @@ export const watchConfigSchema = z.object({
     extensions: z.array(z.string()).default([...CONFIG_DEFAULTS.watch.extensions]),
     /** Command to run when drift is detected */
     onDrift: z.string().optional(),
-}).default(() => ({
+})
+    .default(() => ({
     path: CONFIG_DEFAULTS.watch.path,
     interval: CONFIG_DEFAULTS.watch.interval,
     extensions: [...CONFIG_DEFAULTS.watch.extensions],
@@ -441,48 +574,64 @@ export const watchConfigSchema = z.object({
 /**
  * Discovery configuration schema.
  */
-export const discoveryConfigSchema = z.object({
+export const discoveryConfigSchema = z
+    .object({
     /** Output as JSON */
     json: z.boolean().default(CONFIG_DEFAULTS.discovery.json),
     /** Connection timeout in ms */
-    timeout: z.number().int().min(VALIDATION_BOUNDS.TIMEOUT.MIN_MS).max(VALIDATION_BOUNDS.TIMEOUT.MAX_MS).default(CONFIG_DEFAULTS.discovery.timeout),
+    timeout: z
+        .number()
+        .int()
+        .min(VALIDATION_BOUNDS.TIMEOUT.MIN_MS)
+        .max(VALIDATION_BOUNDS.TIMEOUT.MAX_MS)
+        .default(CONFIG_DEFAULTS.discovery.timeout),
     /** Transport type */
-    transport: z.enum(['stdio', 'sse', 'streamable-http']).default(CONFIG_DEFAULTS.discovery.transport),
+    transport: z
+        .enum(['stdio', 'sse', 'streamable-http'])
+        .default(CONFIG_DEFAULTS.discovery.transport),
     /** Remote MCP server URL */
     url: z.string().optional().default(CONFIG_DEFAULTS.discovery.url),
     /** Session ID for remote auth */
     sessionId: z.string().optional().default(CONFIG_DEFAULTS.discovery.sessionId),
-}).default(CONFIG_DEFAULTS.discovery);
+})
+    .default(CONFIG_DEFAULTS.discovery);
 /**
  * Registry configuration schema.
  */
-export const registryConfigSchema = z.object({
+export const registryConfigSchema = z
+    .object({
     /** Maximum results to show */
     limit: z.number().int().min(1).max(1000).default(CONFIG_DEFAULTS.registry.limit),
     /** Output as JSON */
     json: z.boolean().default(CONFIG_DEFAULTS.registry.json),
-}).default(CONFIG_DEFAULTS.registry);
+})
+    .default(CONFIG_DEFAULTS.registry);
 /**
  * Golden command configuration schema.
  */
-export const goldenConfigSchema = z.object({
+export const goldenConfigSchema = z
+    .object({
     /** Default JSON args for golden save */
     defaultArgs: z.string().default(CONFIG_DEFAULTS.golden.defaultArgs),
     /** Default comparison mode for golden save */
     mode: z.enum(['exact', 'structural', 'semantic']).default(CONFIG_DEFAULTS.golden.mode),
     /** Output format for compare */
-    compareFormat: z.enum(['text', 'json', 'markdown']).default(CONFIG_DEFAULTS.golden.compareFormat),
+    compareFormat: z
+        .enum(['text', 'json', 'markdown'])
+        .default(CONFIG_DEFAULTS.golden.compareFormat),
     /** Output format for list */
     listFormat: z.enum(['text', 'json']).default(CONFIG_DEFAULTS.golden.listFormat),
     /** Normalize timestamps by default */
     normalizeTimestamps: z.boolean().default(CONFIG_DEFAULTS.golden.normalizeTimestamps),
     /** Normalize UUIDs by default */
     normalizeUuids: z.boolean().default(CONFIG_DEFAULTS.golden.normalizeUuids),
-}).default(CONFIG_DEFAULTS.golden);
+})
+    .default(CONFIG_DEFAULTS.golden);
 /**
  * Contract command configuration schema.
  */
-export const contractConfigSchema = z.object({
+export const contractConfigSchema = z
+    .object({
     /** Default contract file path */
     path: z.string().optional(),
     /** Validation mode */
@@ -490,10 +639,16 @@ export const contractConfigSchema = z.object({
     /** Output format */
     format: z.enum(['text', 'json', 'markdown']).default(CONFIG_DEFAULTS.contract.format),
     /** Server startup timeout */
-    timeout: z.number().int().min(VALIDATION_BOUNDS.TIMEOUT.MIN_MS).max(VALIDATION_BOUNDS.TIMEOUT.MAX_MS).default(CONFIG_DEFAULTS.contract.timeout),
+    timeout: z
+        .number()
+        .int()
+        .min(VALIDATION_BOUNDS.TIMEOUT.MIN_MS)
+        .max(VALIDATION_BOUNDS.TIMEOUT.MAX_MS)
+        .default(CONFIG_DEFAULTS.contract.timeout),
     /** Exit with error when violations are found */
     failOnViolation: z.boolean().default(CONFIG_DEFAULTS.contract.failOnViolation),
-}).default(CONFIG_DEFAULTS.contract);
+})
+    .default(CONFIG_DEFAULTS.contract);
 /**
  * Complete bellwether.yaml configuration schema.
  *

package/dist/constants/core.d.ts

@@ -484,6 +484,10 @@ export declare const REPORT_SCHEMAS: {
     readonly CHECK_REPORT_SCHEMA_FILE: "schemas/bellwether-check.schema.json";
     /** Public schema URL for consumers */
     readonly CHECK_REPORT_SCHEMA_URL: "https://unpkg.com/@dotsetlabs/bellwether/schemas/bellwether-check.schema.json";
+    /** Local schema path for bellwether-explore.json */
+    readonly EXPLORE_REPORT_SCHEMA_FILE: "schemas/bellwether-explore.schema.json";
+    /** Public schema URL for consumers */
+    readonly EXPLORE_REPORT_SCHEMA_URL: "https://unpkg.com/@dotsetlabs/bellwether/schemas/bellwether-explore.schema.json";
 };
 /**
  * Regex patterns for validation and parsing.