@dotsetlabs/bellwether 1.0.2 → 2.0.0

package/dist/cli/commands/explore.js

@@ -13,22 +13,23 @@ import { MCPClient } from '../../transport/mcp-client.js';
 import { discover } from '../../discovery/discovery.js';
 import { Interviewer } from '../../interview/interviewer.js';
 import { generateAgentsMd, generateJsonReport } from '../../docs/generator.js';
-import { loadConfig, ConfigNotFoundError, parseCommandString } from '../../config/loader.js';
+import { loadConfig, ConfigNotFoundError, parseCommandString, } from '../../config/loader.js';
 import { validateConfigForExplore } from '../../config/validator.js';
 import { CostTracker, estimateInterviewCost, estimateInterviewTime, formatCostAndTimeEstimate, suggestOptimizations, formatOptimizationSuggestions, } from '../../cost/index.js';
 import { getMetricsCollector, resetMetricsCollector } from '../../metrics/collector.js';
-import { EXIT_CODES, WORKFLOW, PATHS } from '../../constants.js';
+import { EXIT_CODES, WORKFLOW, PATHS, REPORT_SCHEMAS } from '../../constants.js';
 import { FallbackLLMClient } from '../../llm/fallback.js';
 import { getGlobalCache, resetGlobalCache } from '../../cache/response-cache.js';
 import { InterviewProgressBar, formatExploreBanner } from '../utils/progress.js';
 import { parsePersonas } from '../../persona/builtins.js';
-import { loadScenariosFromFile, tryLoadDefaultScenarios, DEFAULT_SCENARIOS_FILE } from '../../scenarios/index.js';
-import { loadWorkflowsFromFile, tryLoadDefaultWorkflows, DEFAULT_WORKFLOWS_FILE } from '../../workflow/loader.js';
+import { loadScenariosFromFile, tryLoadDefaultScenarios, DEFAULT_SCENARIOS_FILE, } from '../../scenarios/index.js';
+import { loadWorkflowsFromFile, tryLoadDefaultWorkflows, DEFAULT_WORKFLOWS_FILE, } from '../../workflow/loader.js';
 import * as output from '../output.js';
 import { StreamingDisplay } from '../output.js';
-import { suppressLogs, restoreLogLevel, configureLogger } from '../../logging/logger.js';
+import { suppressLogs, restoreLogLevel, configureLogger, } from '../../logging/logger.js';
 import { extractServerContextFromArgs } from '../utils/server-context.js';
 import { isCI } from '../utils/env.js';
+import { buildInterviewInsights } from '../../interview/insights.js';
 /**
  * Wrapper to parse personas with warning output.
  */
@@ -120,7 +121,7 @@ export const exploreCommand = new Command('explore')
     metricsCollector.startInterview();
     // Initialize cache
     resetGlobalCache();
-    const cache = getGlobalCache({ enabled: cacheEnabled });
+    const cache = getGlobalCache({ enabled: cacheEnabled, dir: config.cache.dir });
     if (cacheEnabled && verbose) {
         output.info('Response caching enabled');
     }
@@ -138,7 +139,13 @@ export const exploreCommand = new Command('explore')
     };
     try {
         llmClient = new FallbackLLMClient({
-            providers: [{ provider, model, baseUrl: provider === 'ollama' ? config.llm.ollama.baseUrl : undefined }],
+            providers: [
+                {
+                    provider,
+                    model,
+                    baseUrl: provider === 'ollama' ? config.llm.ollama.baseUrl : undefined,
+                },
+            ],
             useOllamaFallback: true,
             onUsage: onUsageCallback,
         });
@@ -166,9 +173,12 @@ export const exploreCommand = new Command('explore')
         }
         // Discovery phase
         output.info('Discovering capabilities...');
-        const discovery = await discover(mcpClient, transport === 'stdio' ? serverCommand : remoteUrl ?? serverCommand, transport === 'stdio' ? args : []);
+        const discovery = await discover(mcpClient, transport === 'stdio' ? serverCommand : (remoteUrl ?? serverCommand), transport === 'stdio' ? args : []);
         const resourceCount = discovery.resources?.length ?? 0;
-        const discoveryParts = [`${discovery.tools.length} tools`, `${discovery.prompts.length} prompts`];
+        const discoveryParts = [
+            `${discovery.tools.length} tools`,
+            `${discovery.prompts.length} prompts`,
+        ];
         if (resourceCount > 0) {
             discoveryParts.push(`${resourceCount} resources`);
         }
@@ -277,13 +287,17 @@ export const exploreCommand = new Command('explore')
                     let prefix = '';
                     switch (opType) {
                         case 'generate-questions':
-                            prefix = context ? `\n  Generating questions for ${context}... ` : '\n  Generating questions... ';
+                            prefix = context
+                                ? `\n  Generating questions for ${context}... `
+                                : '\n  Generating questions... ';
                             break;
                         case 'analyze':
                             prefix = context ? `\n  Analyzing ${context}... ` : '\n  Analyzing... ';
                             break;
                         case 'synthesize-tool':
-                            prefix = context ? `\n  Synthesizing profile for ${context}... ` : '\n  Synthesizing profile... ';
+                            prefix = context
+                                ? `\n  Synthesizing profile for ${context}... `
+                                : '\n  Synthesizing profile... ';
                             break;
                         case 'synthesize-overall':
                             prefix = '\n  Synthesizing overall findings... ';
@@ -365,6 +379,8 @@ export const exploreCommand = new Command('explore')
         };
         output.info('Starting exploration...\n');
         const result = await interviewer.interview(mcpClient, discovery, progressCallback);
+        const insights = buildInterviewInsights(result);
+        const enrichedResult = { ...result, ...insights };
         progressBar.stop();
         if (!verbose) {
             output.newline();
@@ -375,16 +391,20 @@ export const exploreCommand = new Command('explore')
         if (docsDir !== outputDir) {
             mkdirSync(docsDir, { recursive: true });
         }
-        const writeDocs = outputFormat === 'both' || outputFormat === 'agents.md';
+        const writeDocs = outputFormat === 'both' || outputFormat === 'docs';
         const writeJson = outputFormat === 'both' || outputFormat === 'json';
         if (writeDocs) {
-            const agentsMd = generateAgentsMd(result);
+            const agentsMd = generateAgentsMd(enrichedResult);
             const agentsMdPath = join(docsDir, config.output.files.agentsDoc);
             writeFileSync(agentsMdPath, agentsMd);
             output.info(`Written: ${agentsMdPath}`);
         }
         if (writeJson) {
-            const jsonReport = generateJsonReport(result);
+            const jsonReport = generateJsonReport(enrichedResult, {
+                schemaUrl: REPORT_SCHEMAS.EXPLORE_REPORT_SCHEMA_URL,
+                schemaPath: REPORT_SCHEMAS.EXPLORE_REPORT_SCHEMA_FILE,
+                validate: true,
+            });
             const jsonPath = join(outputDir, config.output.files.exploreReport);
             writeFileSync(jsonPath, jsonReport);
             output.info(`Written: ${jsonPath}`);

package/dist/cli/index.js

@@ -16,7 +16,7 @@ if (existsSync(globalEnvPath)) {
     config({ path: globalEnvPath, quiet: true });
 }
 // Then load project .env (overrides global settings)
-config({ quiet: true });
+config({ quiet: true, override: true });
 function normalizeEncryptedEnvVar(key) {
     const value = process.env[key];
     if (!value || !isEncryptedEnvValue(value)) {
@@ -115,6 +115,14 @@ Check MCP servers for drift. Explore behavior. Generate documentation.
 Commands:
   check    - Schema validation and drift detection (free, fast, deterministic)
   explore  - LLM-powered behavioral exploration and documentation
+  discover - Quick capability discovery (no tests)
+  registry - Search the MCP Registry
+  baseline - Manage baselines (save/compare/accept/diff/show)
+  golden   - Golden output regression testing
+  contract - Contract validation (generate/validate/show)
+  watch    - Continuous checking on file changes
+  auth     - Manage LLM provider API keys
+  validate-config - Validate bellwether.yaml without running tests
 
 For more information on a specific command, use:
   bellwether <command> --help`)
@@ -167,9 +175,11 @@ program.configureHelp({
     subcommandTerm: (cmd) => `${cmd.name()} ${cmd.usage()}`,
 });
 // Load keychain credentials, then parse commands
-loadKeychainCredentials().then(() => {
+loadKeychainCredentials()
+    .then(() => {
     program.parse();
-}).catch(() => {
+})
+    .catch(() => {
     // If keychain loading fails, still parse commands
     program.parse();
 });

package/dist/config/template.js

@@ -23,13 +23,11 @@ export function generateConfigTemplate(options = {}) {
     // Override security.enabled if preset specifies it
     const securityEnabledValue = securityEnabled ? 'true' : String(defaults.check.security.enabled);
     const serverArgsYaml = serverArgs.length > 0
-        ? `\n  args:\n${serverArgs.map(arg => `    - "${arg}"`).join('\n')}`
+        ? `\n  args:\n${serverArgs.map((arg) => `    - "${arg}"`).join('\n')}`
         : '\n  args: []';
     const presetComment = preset ? `# Generated with: bellwether init --preset ${preset}\n` : '';
     // Generate env section if env vars were detected
-    const envVarsYaml = envVars.length > 0
-        ? `\n  env:\n${envVars.map(v => `    ${v}: "\${${v}}"`).join('\n')}`
-        : '';
+    const envVarsYaml = envVars.length > 0 ? `\n  env:\n${envVars.map((v) => `    ${v}: "\${${v}}"`).join('\n')}` : '';
     return `# Bellwether Configuration
 # Generated by: bellwether init
 # Docs: https://docs.bellwether.sh/guides/configuration
@@ -61,10 +59,12 @@ server:
   timeout: ${defaults.server.timeout}
 
   # Additional environment variables for the server process
-  # Use \${VAR} syntax to reference environment variables${envVarsYaml}${envVars.length === 0 ? `
+  # Use \${VAR} syntax to reference environment variables${envVarsYaml}${envVars.length === 0
+        ? `
   # env:
   #   NODE_ENV: production
-  #   API_KEY: "\${API_KEY}"` : ''}
+  #   API_KEY: "\${API_KEY}"`
+        : ''}
 
 # =============================================================================
 # SCENARIOS (used by both commands)
@@ -91,7 +91,8 @@ output:
   # These are kept in root by default for visibility
   docsDir: "${defaults.output.docsDir}"
 
-  # Output format: agents.md (markdown only), json (JSON only), or both
+  # Output format: docs (markdown only), json (JSON only), or both
+  # Legacy alias: agents.md (treated as docs)
   format: ${defaults.output.format}
 
   # Example output settings (for CONTRACT.md and AGENTS.md)

package/dist/config/validator.d.ts

@@ -247,7 +247,7 @@ export declare const outputConfigSchema: z.ZodDefault<z.ZodObject<{
     /** Output directory for documentation files (CONTRACT.md, AGENTS.md) */
     docsDir: z.ZodDefault<z.ZodString>;
     /** Output format */
-    format: z.ZodDefault<z.ZodEnum<["agents.md", "json", "both"]>>;
+    format: z.ZodDefault<z.ZodEffects<z.ZodEnum<["docs", "json", "both"]>, "json" | "both" | "docs", unknown>>;
     /** Example output settings */
     examples: z.ZodDefault<z.ZodObject<{
         /** Include full (non-truncated) examples */
@@ -287,7 +287,7 @@ export declare const outputConfigSchema: z.ZodDefault<z.ZodObject<{
         agentsDoc?: string | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    format: "json" | "both" | "agents.md";
+    format: "json" | "both" | "docs";
     examples: {
         maxLength: number;
         full: boolean;
@@ -302,7 +302,7 @@ export declare const outputConfigSchema: z.ZodDefault<z.ZodObject<{
     };
     docsDir: string;
 }, {
-    format?: "json" | "both" | "agents.md" | undefined;
+    format?: unknown;
     examples?: {
         maxLength?: number | undefined;
         full?: boolean | undefined;
@@ -329,17 +329,17 @@ export declare const severityConfigSchema: z.ZodDefault<z.ZodObject<{
     /** Suppress warning-level changes from output */
     suppressWarnings: z.ZodDefault<z.ZodBoolean>;
     /** Custom severity overrides per aspect */
-    aspectOverrides: z.ZodOptional<z.ZodRecord<z.ZodEnum<["response_format", "response_structure", "error_handling", "error_pattern", "security", "performance", "schema", "description"]>, z.ZodEnum<["none", "info", "warning", "breaking"]>>>;
+    aspectOverrides: z.ZodOptional<z.ZodRecord<z.ZodEnum<["response_format", "response_structure", "response_schema_evolution", "error_handling", "error_pattern", "security", "performance", "schema", "description", "prompt", "resource", "server", "capability"]>, z.ZodEnum<["none", "info", "warning", "breaking"]>>>;
 }, "strip", z.ZodTypeAny, {
     minimumSeverity: "none" | "info" | "warning" | "breaking";
     failOnSeverity: "none" | "info" | "warning" | "breaking";
     suppressWarnings: boolean;
-    aspectOverrides?: Partial<Record<"error_handling" | "security" | "response_format" | "response_structure" | "error_pattern" | "performance" | "schema" | "description", "none" | "info" | "warning" | "breaking">> | undefined;
+    aspectOverrides?: Partial<Record<"error_handling" | "resource" | "server" | "security" | "response_format" | "response_structure" | "response_schema_evolution" | "error_pattern" | "performance" | "schema" | "description" | "prompt" | "capability", "none" | "info" | "warning" | "breaking">> | undefined;
 }, {
     minimumSeverity?: "none" | "info" | "warning" | "breaking" | undefined;
     failOnSeverity?: "none" | "info" | "warning" | "breaking" | undefined;
     suppressWarnings?: boolean | undefined;
-    aspectOverrides?: Partial<Record<"error_handling" | "security" | "response_format" | "response_structure" | "error_pattern" | "performance" | "schema" | "description", "none" | "info" | "warning" | "breaking">> | undefined;
+    aspectOverrides?: Partial<Record<"error_handling" | "resource" | "server" | "security" | "response_format" | "response_structure" | "response_schema_evolution" | "error_pattern" | "performance" | "schema" | "description" | "prompt" | "capability", "none" | "info" | "warning" | "breaking">> | undefined;
 }>>;
 /**
  * Security testing configuration schema.
@@ -864,17 +864,17 @@ export declare const baselineConfigSchema: z.ZodDefault<z.ZodObject<{
         /** Suppress warning-level changes from output */
         suppressWarnings: z.ZodDefault<z.ZodBoolean>;
         /** Custom severity overrides per aspect */
-        aspectOverrides: z.ZodOptional<z.ZodRecord<z.ZodEnum<["response_format", "response_structure", "error_handling", "error_pattern", "security", "performance", "schema", "description"]>, z.ZodEnum<["none", "info", "warning", "breaking"]>>>;
+        aspectOverrides: z.ZodOptional<z.ZodRecord<z.ZodEnum<["response_format", "response_structure", "response_schema_evolution", "error_handling", "error_pattern", "security", "performance", "schema", "description", "prompt", "resource", "server", "capability"]>, z.ZodEnum<["none", "info", "warning", "breaking"]>>>;
     }, "strip", z.ZodTypeAny, {
         minimumSeverity: "none" | "info" | "warning" | "breaking";
         failOnSeverity: "none" | "info" | "warning" | "breaking";
         suppressWarnings: boolean;
-        aspectOverrides?: Partial<Record<"error_handling" | "security" | "response_format" | "response_structure" | "error_pattern" | "performance" | "schema" | "description", "none" | "info" | "warning" | "breaking">> | undefined;
+        aspectOverrides?: Partial<Record<"error_handling" | "resource" | "server" | "security" | "response_format" | "response_structure" | "response_schema_evolution" | "error_pattern" | "performance" | "schema" | "description" | "prompt" | "capability", "none" | "info" | "warning" | "breaking">> | undefined;
     }, {
         minimumSeverity?: "none" | "info" | "warning" | "breaking" | undefined;
         failOnSeverity?: "none" | "info" | "warning" | "breaking" | undefined;
         suppressWarnings?: boolean | undefined;
-        aspectOverrides?: Partial<Record<"error_handling" | "security" | "response_format" | "response_structure" | "error_pattern" | "performance" | "schema" | "description", "none" | "info" | "warning" | "breaking">> | undefined;
+        aspectOverrides?: Partial<Record<"error_handling" | "resource" | "server" | "security" | "response_format" | "response_structure" | "response_schema_evolution" | "error_pattern" | "performance" | "schema" | "description" | "prompt" | "capability", "none" | "info" | "warning" | "breaking">> | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     path: string;
@@ -882,7 +882,7 @@ export declare const baselineConfigSchema: z.ZodDefault<z.ZodObject<{
         minimumSeverity: "none" | "info" | "warning" | "breaking";
         failOnSeverity: "none" | "info" | "warning" | "breaking";
         suppressWarnings: boolean;
-        aspectOverrides?: Partial<Record<"error_handling" | "security" | "response_format" | "response_structure" | "error_pattern" | "performance" | "schema" | "description", "none" | "info" | "warning" | "breaking">> | undefined;
+        aspectOverrides?: Partial<Record<"error_handling" | "resource" | "server" | "security" | "response_format" | "response_structure" | "response_schema_evolution" | "error_pattern" | "performance" | "schema" | "description" | "prompt" | "capability", "none" | "info" | "warning" | "breaking">> | undefined;
     };
     failOnDrift: boolean;
     outputFormat: "text" | "json" | "markdown" | "compact";
@@ -894,7 +894,7 @@ export declare const baselineConfigSchema: z.ZodDefault<z.ZodObject<{
         minimumSeverity?: "none" | "info" | "warning" | "breaking" | undefined;
         failOnSeverity?: "none" | "info" | "warning" | "breaking" | undefined;
         suppressWarnings?: boolean | undefined;
-        aspectOverrides?: Partial<Record<"error_handling" | "security" | "response_format" | "response_structure" | "error_pattern" | "performance" | "schema" | "description", "none" | "info" | "warning" | "breaking">> | undefined;
+        aspectOverrides?: Partial<Record<"error_handling" | "resource" | "server" | "security" | "response_format" | "response_structure" | "response_schema_evolution" | "error_pattern" | "performance" | "schema" | "description" | "prompt" | "capability", "none" | "info" | "warning" | "breaking">> | undefined;
     } | undefined;
     savePath?: string | undefined;
     comparePath?: string | undefined;
@@ -1013,14 +1013,14 @@ export declare const goldenConfigSchema: z.ZodDefault<z.ZodObject<{
     /** Normalize UUIDs by default */
     normalizeUuids: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
-    mode: "semantic" | "structural" | "exact";
+    mode: "structural" | "exact" | "semantic";
     defaultArgs: string;
     compareFormat: "text" | "json" | "markdown";
     listFormat: "text" | "json";
     normalizeTimestamps: boolean;
     normalizeUuids: boolean;
 }, {
-    mode?: "semantic" | "structural" | "exact" | undefined;
+    mode?: "structural" | "exact" | "semantic" | undefined;
     defaultArgs?: string | undefined;
     compareFormat?: "text" | "json" | "markdown" | undefined;
     listFormat?: "text" | "json" | undefined;
@@ -1525,7 +1525,7 @@ export declare const bellwetherConfigSchema: z.ZodObject<{
         /** Output directory for documentation files (CONTRACT.md, AGENTS.md) */
         docsDir: z.ZodDefault<z.ZodString>;
         /** Output format */
-        format: z.ZodDefault<z.ZodEnum<["agents.md", "json", "both"]>>;
+        format: z.ZodDefault<z.ZodEffects<z.ZodEnum<["docs", "json", "both"]>, "json" | "both" | "docs", unknown>>;
         /** Example output settings */
         examples: z.ZodDefault<z.ZodObject<{
             /** Include full (non-truncated) examples */
@@ -1565,7 +1565,7 @@ export declare const bellwetherConfigSchema: z.ZodObject<{
             agentsDoc?: string | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
-        format: "json" | "both" | "agents.md";
+        format: "json" | "both" | "docs";
         examples: {
             maxLength: number;
             full: boolean;
@@ -1580,7 +1580,7 @@ export declare const bellwetherConfigSchema: z.ZodObject<{
         };
         docsDir: string;
     }, {
-        format?: "json" | "both" | "agents.md" | undefined;
+        format?: unknown;
         examples?: {
             maxLength?: number | undefined;
             full?: boolean | undefined;
@@ -1616,17 +1616,17 @@ export declare const bellwetherConfigSchema: z.ZodObject<{
             /** Suppress warning-level changes from output */
             suppressWarnings: z.ZodDefault<z.ZodBoolean>;
             /** Custom severity overrides per aspect */
-            aspectOverrides: z.ZodOptional<z.ZodRecord<z.ZodEnum<["response_format", "response_structure", "error_handling", "error_pattern", "security", "performance", "schema", "description"]>, z.ZodEnum<["none", "info", "warning", "breaking"]>>>;
+            aspectOverrides: z.ZodOptional<z.ZodRecord<z.ZodEnum<["response_format", "response_structure", "response_schema_evolution", "error_handling", "error_pattern", "security", "performance", "schema", "description", "prompt", "resource", "server", "capability"]>, z.ZodEnum<["none", "info", "warning", "breaking"]>>>;
         }, "strip", z.ZodTypeAny, {
             minimumSeverity: "none" | "info" | "warning" | "breaking";
             failOnSeverity: "none" | "info" | "warning" | "breaking";
             suppressWarnings: boolean;
-            aspectOverrides?: Partial<Record<"error_handling" | "security" | "response_format" | "response_structure" | "error_pattern" | "performance" | "schema" | "description", "none" | "info" | "warning" | "breaking">> | undefined;
+            aspectOverrides?: Partial<Record<"error_handling" | "resource" | "server" | "security" | "response_format" | "response_structure" | "response_schema_evolution" | "error_pattern" | "performance" | "schema" | "description" | "prompt" | "capability", "none" | "info" | "warning" | "breaking">> | undefined;
         }, {
             minimumSeverity?: "none" | "info" | "warning" | "breaking" | undefined;
             failOnSeverity?: "none" | "info" | "warning" | "breaking" | undefined;
             suppressWarnings?: boolean | undefined;
-            aspectOverrides?: Partial<Record<"error_handling" | "security" | "response_format" | "response_structure" | "error_pattern" | "performance" | "schema" | "description", "none" | "info" | "warning" | "breaking">> | undefined;
+            aspectOverrides?: Partial<Record<"error_handling" | "resource" | "server" | "security" | "response_format" | "response_structure" | "response_schema_evolution" | "error_pattern" | "performance" | "schema" | "description" | "prompt" | "capability", "none" | "info" | "warning" | "breaking">> | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
         path: string;
@@ -1634,7 +1634,7 @@ export declare const bellwetherConfigSchema: z.ZodObject<{
             minimumSeverity: "none" | "info" | "warning" | "breaking";
             failOnSeverity: "none" | "info" | "warning" | "breaking";
             suppressWarnings: boolean;
-            aspectOverrides?: Partial<Record<"error_handling" | "security" | "response_format" | "response_structure" | "error_pattern" | "performance" | "schema" | "description", "none" | "info" | "warning" | "breaking">> | undefined;
+            aspectOverrides?: Partial<Record<"error_handling" | "resource" | "server" | "security" | "response_format" | "response_structure" | "response_schema_evolution" | "error_pattern" | "performance" | "schema" | "description" | "prompt" | "capability", "none" | "info" | "warning" | "breaking">> | undefined;
         };
         failOnDrift: boolean;
         outputFormat: "text" | "json" | "markdown" | "compact";
@@ -1646,7 +1646,7 @@ export declare const bellwetherConfigSchema: z.ZodObject<{
             minimumSeverity?: "none" | "info" | "warning" | "breaking" | undefined;
             failOnSeverity?: "none" | "info" | "warning" | "breaking" | undefined;
             suppressWarnings?: boolean | undefined;
-            aspectOverrides?: Partial<Record<"error_handling" | "security" | "response_format" | "response_structure" | "error_pattern" | "performance" | "schema" | "description", "none" | "info" | "warning" | "breaking">> | undefined;
+            aspectOverrides?: Partial<Record<"error_handling" | "resource" | "server" | "security" | "response_format" | "response_structure" | "response_schema_evolution" | "error_pattern" | "performance" | "schema" | "description" | "prompt" | "capability", "none" | "info" | "warning" | "breaking">> | undefined;
         } | undefined;
         savePath?: string | undefined;
         comparePath?: string | undefined;
@@ -1753,14 +1753,14 @@ export declare const bellwetherConfigSchema: z.ZodObject<{
         /** Normalize UUIDs by default */
         normalizeUuids: z.ZodDefault<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
-        mode: "semantic" | "structural" | "exact";
+        mode: "structural" | "exact" | "semantic";
         defaultArgs: string;
         compareFormat: "text" | "json" | "markdown";
         listFormat: "text" | "json";
         normalizeTimestamps: boolean;
         normalizeUuids: boolean;
     }, {
-        mode?: "semantic" | "structural" | "exact" | undefined;
+        mode?: "structural" | "exact" | "semantic" | undefined;
         defaultArgs?: string | undefined;
         compareFormat?: "text" | "json" | "markdown" | undefined;
         listFormat?: "text" | "json" | undefined;
@@ -1793,22 +1793,6 @@ export declare const bellwetherConfigSchema: z.ZodObject<{
         failOnViolation?: boolean | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    output: {
-        format: "json" | "both" | "agents.md";
-        examples: {
-            maxLength: number;
-            full: boolean;
-            maxPerTool: number;
-        };
-        dir: string;
-        files: {
-            checkReport: string;
-            exploreReport: string;
-            contractDoc: string;
-            agentsDoc: string;
-        };
-        docsDir: string;
-    };
     server: {
         command: string;
         args: string[];
@@ -1886,6 +1870,22 @@ export declare const bellwetherConfigSchema: z.ZodObject<{
         parallelPersonas: boolean;
         personaConcurrency: number;
     };
+    output: {
+        format: "json" | "both" | "docs";
+        examples: {
+            maxLength: number;
+            full: boolean;
+            maxPerTool: number;
+        };
+        dir: string;
+        files: {
+            checkReport: string;
+            exploreReport: string;
+            contractDoc: string;
+            agentsDoc: string;
+        };
+        docsDir: string;
+    };
     cache: {
         enabled: boolean;
         dir: string;
@@ -1924,7 +1924,7 @@ export declare const bellwetherConfigSchema: z.ZodObject<{
             minimumSeverity: "none" | "info" | "warning" | "breaking";
             failOnSeverity: "none" | "info" | "warning" | "breaking";
             suppressWarnings: boolean;
-            aspectOverrides?: Partial<Record<"error_handling" | "security" | "response_format" | "response_structure" | "error_pattern" | "performance" | "schema" | "description", "none" | "info" | "warning" | "breaking">> | undefined;
+            aspectOverrides?: Partial<Record<"error_handling" | "resource" | "server" | "security" | "response_format" | "response_structure" | "response_schema_evolution" | "error_pattern" | "performance" | "schema" | "description" | "prompt" | "capability", "none" | "info" | "warning" | "breaking">> | undefined;
         };
         failOnDrift: boolean;
         outputFormat: "text" | "json" | "markdown" | "compact";
@@ -1946,7 +1946,7 @@ export declare const bellwetherConfigSchema: z.ZodObject<{
         limit: number;
     };
     golden: {
-        mode: "semantic" | "structural" | "exact";
+        mode: "structural" | "exact" | "semantic";
         defaultArgs: string;
         compareFormat: "text" | "json" | "markdown";
         listFormat: "text" | "json";
@@ -1961,22 +1961,6 @@ export declare const bellwetherConfigSchema: z.ZodObject<{
         path?: string | undefined;
     };
 }, {
-    output?: {
-        format?: "json" | "both" | "agents.md" | undefined;
-        examples?: {
-            maxLength?: number | undefined;
-            full?: boolean | undefined;
-            maxPerTool?: number | undefined;
-        } | undefined;
-        dir?: string | undefined;
-        files?: {
-            checkReport?: string | undefined;
-            exploreReport?: string | undefined;
-            contractDoc?: string | undefined;
-            agentsDoc?: string | undefined;
-        } | undefined;
-        docsDir?: string | undefined;
-    } | undefined;
     server?: {
         command?: string | undefined;
         args?: string[] | undefined;
@@ -2054,6 +2038,22 @@ export declare const bellwetherConfigSchema: z.ZodObject<{
         parallelPersonas?: boolean | undefined;
         personaConcurrency?: number | undefined;
     } | undefined;
+    output?: {
+        format?: unknown;
+        examples?: {
+            maxLength?: number | undefined;
+            full?: boolean | undefined;
+            maxPerTool?: number | undefined;
+        } | undefined;
+        dir?: string | undefined;
+        files?: {
+            checkReport?: string | undefined;
+            exploreReport?: string | undefined;
+            contractDoc?: string | undefined;
+            agentsDoc?: string | undefined;
+        } | undefined;
+        docsDir?: string | undefined;
+    } | undefined;
     cache?: {
         enabled?: boolean | undefined;
         dir?: string | undefined;
@@ -2092,7 +2092,7 @@ export declare const bellwetherConfigSchema: z.ZodObject<{
             minimumSeverity?: "none" | "info" | "warning" | "breaking" | undefined;
             failOnSeverity?: "none" | "info" | "warning" | "breaking" | undefined;
             suppressWarnings?: boolean | undefined;
-            aspectOverrides?: Partial<Record<"error_handling" | "security" | "response_format" | "response_structure" | "error_pattern" | "performance" | "schema" | "description", "none" | "info" | "warning" | "breaking">> | undefined;
+            aspectOverrides?: Partial<Record<"error_handling" | "resource" | "server" | "security" | "response_format" | "response_structure" | "response_schema_evolution" | "error_pattern" | "performance" | "schema" | "description" | "prompt" | "capability", "none" | "info" | "warning" | "breaking">> | undefined;
         } | undefined;
         savePath?: string | undefined;
         comparePath?: string | undefined;
@@ -2114,7 +2114,7 @@ export declare const bellwetherConfigSchema: z.ZodObject<{
         limit?: number | undefined;
     } | undefined;
     golden?: {
-        mode?: "semantic" | "structural" | "exact" | undefined;
+        mode?: "structural" | "exact" | "semantic" | undefined;
         defaultArgs?: string | undefined;
         compareFormat?: "text" | "json" | "markdown" | undefined;
         listFormat?: "text" | "json" | undefined;