@vibe-validate/cli 0.10.3 → 0.12.0

package/dist/utils/setup-checks/gitignore-check.js

@@ -1,156 +1,38 @@
 /**
- * Gitignore Setup Check
+ * Gitignore Setup Check (DEPRECATED)
  *
- * Ensures that .vibe-validate-state.yaml is listed in .gitignore
- * to prevent committing validation state files.
+ * @deprecated Since v0.12.0 - State file (.vibe-validate-state.yaml) is deprecated.
+ * Validation history is now stored in git notes instead of a state file.
+ * This check always passes and does not modify .gitignore.
+ *
+ * Use `vibe-validate doctor` to detect and remove deprecated state file entries.
  */
-import { readFile, writeFile } from 'fs/promises';
-import { existsSync } from 'fs';
-import { join } from 'path';
-const STATE_FILE_ENTRY = '.vibe-validate-state.yaml';
 export class GitignoreSetupCheck {
     id = 'gitignore';
-    name = 'Gitignore Setup';
-    async check(options) {
-        const cwd = options?.cwd ?? process.cwd();
-        const gitignorePath = join(cwd, '.gitignore');
-        // Check if .gitignore exists
-        if (!existsSync(gitignorePath)) {
-            return {
-                passed: false,
-                message: '.gitignore not found',
-                suggestion: `Create .gitignore and add ${STATE_FILE_ENTRY}`,
-            };
-        }
-        // Read .gitignore content
-        const content = await readFile(gitignorePath, 'utf-8');
-        // Check if state file entry exists (with flexible whitespace)
-        const hasEntry = content
-            .split('\n')
-            .some(line => line.trim() === STATE_FILE_ENTRY);
-        if (!hasEntry) {
-            return {
-                passed: false,
-                message: `.gitignore missing ${STATE_FILE_ENTRY} entry`,
-                suggestion: `Add ${STATE_FILE_ENTRY} to .gitignore`,
-            };
-        }
+    name = 'Gitignore Setup (deprecated)';
+    async check(_options) {
+        // DEPRECATED: State file is no longer used (git notes replaced it in v0.12.0)
+        // Always return passed - no .gitignore modifications needed
         return {
             passed: true,
-            message: '.gitignore correctly configured with state file entry',
+            message: '.gitignore check skipped (state file deprecated in v0.12.0)',
         };
     }
-    async preview(options) {
-        const cwd = options?.cwd ?? process.cwd();
-        const gitignorePath = join(cwd, '.gitignore');
-        // Check current state
-        const checkResult = await this.check(options);
-        if (checkResult.passed) {
-            return {
-                description: '.gitignore already configured correctly',
-                filesAffected: [],
-                changes: [],
-            };
-        }
-        // If .gitignore doesn't exist
-        if (!existsSync(gitignorePath)) {
-            const content = this.generateNewGitignoreContent();
-            return {
-                description: 'Create new .gitignore with vibe-validate state file entry',
-                filesAffected: ['.gitignore'],
-                changes: [
-                    {
-                        file: '.gitignore',
-                        action: 'create',
-                        content,
-                    },
-                ],
-            };
-        }
-        // If .gitignore exists but missing entry
+    async preview(_options) {
+        // DEPRECATED: No .gitignore modifications needed (state file deprecated)
         return {
-            description: `Add ${STATE_FILE_ENTRY} entry to existing .gitignore`,
-            filesAffected: ['.gitignore'],
-            changes: [
-                {
-                    file: '.gitignore',
-                    action: 'modify',
-                },
-            ],
+            description: 'Gitignore check deprecated (state file no longer used)',
+            filesAffected: [],
+            changes: [],
         };
     }
-    async fix(options) {
-        const cwd = options?.cwd ?? process.cwd();
-        const gitignorePath = join(cwd, '.gitignore');
-        const dryRun = options?.dryRun ?? false;
-        // Check current state
-        const checkResult = await this.check(options);
-        if (checkResult.passed && !options?.force) {
-            return {
-                success: true,
-                message: '.gitignore already configured correctly',
-                filesChanged: [],
-            };
-        }
-        if (dryRun) {
-            return {
-                success: true,
-                message: '[dry-run] Would update .gitignore',
-                filesChanged: [],
-            };
-        }
-        // If .gitignore doesn't exist, create it
-        if (!existsSync(gitignorePath)) {
-            const content = this.generateNewGitignoreContent();
-            await writeFile(gitignorePath, content, 'utf-8');
-            return {
-                success: true,
-                message: 'Created .gitignore with state file entry',
-                filesChanged: ['.gitignore'],
-            };
-        }
-        // If .gitignore exists, add entry if missing
-        const content = await readFile(gitignorePath, 'utf-8');
-        const hasEntry = content
-            .split('\n')
-            .some(line => line.trim() === STATE_FILE_ENTRY);
-        if (hasEntry) {
-            // Entry already exists (idempotent)
-            return {
-                success: true,
-                message: '.gitignore already contains state file entry',
-                filesChanged: [],
-            };
-        }
-        // Add entry to existing .gitignore
-        const updatedContent = this.addEntryToGitignore(content);
-        await writeFile(gitignorePath, updatedContent, 'utf-8');
+    async fix(_options) {
+        // DEPRECATED: No .gitignore modifications needed (state file deprecated)
         return {
             success: true,
-            message: `Added ${STATE_FILE_ENTRY} to .gitignore`,
-            filesChanged: ['.gitignore'],
+            message: 'Gitignore check deprecated (state file no longer used)',
+            filesChanged: [],
         };
     }
-    /**
-     * Generate content for a new .gitignore file
-     */
-    generateNewGitignoreContent() {
-        return `# vibe-validate
-${STATE_FILE_ENTRY}
-`;
-    }
-    /**
-     * Add state file entry to existing .gitignore content
-     */
-    addEntryToGitignore(content) {
-        // Ensure content ends with newline
-        let updatedContent = content;
-        if (!content.endsWith('\n')) {
-            updatedContent += '\n';
-        }
-        // Add vibe-validate section
-        updatedContent += `\n# vibe-validate\n${STATE_FILE_ENTRY}\n`;
-        return updatedContent;
-    }
 }
 //# sourceMappingURL=gitignore-check.js.map

package/dist/utils/setup-checks/gitignore-check.js.map

@@ -1 +1 @@
-{"version":3,"file":"gitignore-check.js","sourceRoot":"","sources":["../../../src/utils/setup-checks/gitignore-check.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"gitignore-check.js","sourceRoot":"","sources":["../../../src/utils/setup-checks/gitignore-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,MAAM,OAAO,mBAAmB;IACrB,EAAE,GAAG,WAAW,CAAC;IACjB,IAAI,GAAG,8BAA8B,CAAC;IAE/C,KAAK,CAAC,KAAK,CAAC,QAAqB;QAC/B,8EAA8E;QAC9E,4DAA4D;QAC5D,OAAO;YACL,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,6DAA6D;SACvE,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAqB;QACjC,yEAAyE;QACzE,OAAO;YACL,WAAW,EAAE,wDAAwD;YACrE,aAAa,EAAE,EAAE;YACjB,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,QAAqB;QAC7B,yEAAyE;QACzE,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,wDAAwD;YACjE,YAAY,EAAE,EAAE;SACjB,CAAC;IACJ,CAAC;CACF"}

package/dist/utils/template-discovery.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Template Discovery Utility
+ *
+ * Discovers and reads metadata from config templates in the config-templates/ directory.
+ */
+/**
+ * Metadata for a config template
+ */
+export interface TemplateMetadata {
+    /** Template filename (e.g., "typescript-nodejs.yaml") */
+    filename: string;
+    /** Display name extracted from header comment (e.g., "TypeScript for Node.js") */
+    displayName: string;
+    /** Short description extracted from template (e.g., "Node.js apps, APIs, and backend services") */
+    description: string;
+}
+/**
+ * Discover all available config templates
+ *
+ * Scans the config-templates/ directory and extracts metadata from each template.
+ * Results are sorted alphabetically by filename.
+ *
+ * @returns Array of template metadata
+ */
+export declare function discoverTemplates(): TemplateMetadata[];
+/**
+ * Format template list for CLI output
+ *
+ * Creates a human-readable list of templates with descriptions.
+ *
+ * Example output:
+ * ```
+ * • typescript-library.yaml - TypeScript libraries and npm packages
+ * • typescript-nodejs.yaml - Node.js apps, APIs, and backend services
+ * ```
+ *
+ * @returns Formatted template list (one template per line)
+ */
+export declare function formatTemplateList(): string[];
+//# sourceMappingURL=template-discovery.d.ts.map

package/dist/utils/template-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-discovery.d.ts","sourceRoot":"","sources":["../../src/utils/template-discovery.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,WAAW,EAAE,MAAM,CAAC;IACpB,mGAAmG;IACnG,WAAW,EAAE,MAAM,CAAC;CACrB;AAoFD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,IAAI,gBAAgB,EAAE,CAsBtD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAa7C"}

package/dist/utils/template-discovery.js

@@ -0,0 +1,136 @@
+/**
+ * Template Discovery Utility
+ *
+ * Discovers and reads metadata from config templates in the config-templates/ directory.
+ */
+import { readdirSync, readFileSync, existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { splitLines } from './normalize-line-endings.js';
+/**
+ * Get the absolute path to the config-templates directory
+ *
+ * This function works both in development (from source) and when installed as npm package.
+ *
+ * @returns Absolute path to config-templates directory
+ */
+function getTemplatesDir() {
+    // In production (npm package), templates are at <package-root>/config-templates
+    // In development, templates are at <repo-root>/config-templates
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    // Try paths in order:
+    // 1. Development: packages/cli/src/utils/../../../config-templates
+    const devPath = join(__dirname, '../../../../config-templates');
+    if (existsSync(devPath)) {
+        return devPath;
+    }
+    // 2. Production: packages/cli/dist/utils/../../config-templates
+    const prodPath = join(__dirname, '../../../config-templates');
+    if (existsSync(prodPath)) {
+        return prodPath;
+    }
+    // 3. Fallback: assume monorepo root
+    const fallbackPath = join(process.cwd(), 'config-templates');
+    return fallbackPath;
+}
+/**
+ * Extract template metadata from YAML file
+ *
+ * Parses the header comment block to extract display name and description.
+ *
+ * Expected format:
+ * ```yaml
+ * # ============================================================================
+ * # CONFIGURATION TEMPLATE - vibe-validate for TypeScript Libraries
+ * # ============================================================================
+ * # ...
+ * # This template is optimized for TypeScript libraries and npm packages.
+ * ```
+ *
+ * @param filename - Template filename
+ * @param content - Template file content
+ * @returns Template metadata
+ */
+function parseTemplateMetadata(filename, content) {
+    const lines = splitLines(content);
+    // Find the title line (line 2, format: "# CONFIGURATION TEMPLATE - <title>")
+    let displayName = filename.replace('.yaml', '');
+    const titleLine = lines.find(line => line.includes('CONFIGURATION TEMPLATE -'));
+    if (titleLine) {
+        const match = titleLine.match(/CONFIGURATION TEMPLATE\s*-\s*(.+)/);
+        if (match) {
+            displayName = match[1].trim();
+            // Remove "vibe-validate for " prefix if present
+            displayName = displayName.replace(/^vibe-validate for\s+/i, '');
+        }
+    }
+    // Find the description (first line starting with "# This template is")
+    let description = '';
+    const descLine = lines.find(line => line.trim().startsWith('# This template is'));
+    if (descLine) {
+        description = descLine.replace(/^#\s*This template is\s+/, '').replace(/\.$/, '').trim();
+        // Capitalize first letter
+        if (description.length > 0) {
+            description = description.charAt(0).toUpperCase() + description.slice(1);
+        }
+    }
+    return {
+        filename,
+        displayName,
+        description,
+    };
+}
+/**
+ * Discover all available config templates
+ *
+ * Scans the config-templates/ directory and extracts metadata from each template.
+ * Results are sorted alphabetically by filename.
+ *
+ * @returns Array of template metadata
+ */
+export function discoverTemplates() {
+    const templatesDir = getTemplatesDir();
+    // Check if directory exists
+    if (!existsSync(templatesDir)) {
+        return [];
+    }
+    // Read all .yaml files
+    const files = readdirSync(templatesDir)
+        .filter(file => file.endsWith('.yaml'))
+        .sort();
+    // Parse metadata from each template
+    const templates = [];
+    for (const file of files) {
+        const filePath = join(templatesDir, file);
+        const content = readFileSync(filePath, 'utf-8');
+        templates.push(parseTemplateMetadata(file, content));
+    }
+    return templates;
+}
+/**
+ * Format template list for CLI output
+ *
+ * Creates a human-readable list of templates with descriptions.
+ *
+ * Example output:
+ * ```
+ * • typescript-library.yaml - TypeScript libraries and npm packages
+ * • typescript-nodejs.yaml - Node.js apps, APIs, and backend services
+ * ```
+ *
+ * @returns Formatted template list (one template per line)
+ */
+export function formatTemplateList() {
+    const templates = discoverTemplates();
+    if (templates.length === 0) {
+        return ['No templates found'];
+    }
+    return templates.map(t => {
+        if (t.description) {
+            return `• ${t.filename} - ${t.description}`;
+        }
+        return `• ${t.filename}`;
+    });
+}
+//# sourceMappingURL=template-discovery.js.map

package/dist/utils/template-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-discovery.js","sourceRoot":"","sources":["../../src/utils/template-discovery.ts"],"names":[],"mappings":"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"}

package/dist/utils/validate-workflow.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Shared Validation Workflow
+ *
+ * Core validation logic used by both validate and pre-commit commands.
+ * Handles caching, history recording, and output formatting.
+ */
+import type { VibeValidateConfig } from '@vibe-validate/config';
+import type { ValidationResult } from '@vibe-validate/core';
+import type { AgentContext } from './context-detector.js';
+export interface ValidateWorkflowOptions {
+    force?: boolean;
+    verbose?: boolean;
+    yaml?: boolean;
+    check?: boolean;
+    context: AgentContext;
+}
+/**
+ * Execute validation workflow with caching, history recording, and output formatting.
+ *
+ * This is the shared implementation used by both `validate` and `pre-commit` commands.
+ *
+ * @param config - Loaded vibe-validate configuration
+ * @param options - Validation options (force, verbose, yaml, check, context)
+ * @returns Validation result
+ * @throws Error if validation encounters fatal error
+ */
+export declare function runValidateWorkflow(config: VibeValidateConfig, options: ValidateWorkflowOptions): Promise<ValidationResult>;
+//# sourceMappingURL=validate-workflow.d.ts.map

package/dist/utils/validate-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-workflow.d.ts","sourceRoot":"","sources":["../../src/utils/validate-workflow.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAS5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAK1D,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,YAAY,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,gBAAgB,CAAC,CAmP3B"}

package/dist/utils/validate-workflow.js

@@ -0,0 +1,247 @@
+/**
+ * Shared Validation Workflow
+ *
+ * Core validation logic used by both validate and pre-commit commands.
+ * Handles caching, history recording, and output formatting.
+ */
+import { runValidation } from '@vibe-validate/core';
+import { getGitTreeHash } from '@vibe-validate/git';
+import { recordValidationHistory, checkWorktreeStability, checkHistoryHealth, readHistoryNote, } from '@vibe-validate/history';
+import { createRunnerConfig } from './runner-adapter.js';
+import chalk from 'chalk';
+import { stringify as yamlStringify } from 'yaml';
+/**
+ * Execute validation workflow with caching, history recording, and output formatting.
+ *
+ * This is the shared implementation used by both `validate` and `pre-commit` commands.
+ *
+ * @param config - Loaded vibe-validate configuration
+ * @param options - Validation options (force, verbose, yaml, check, context)
+ * @returns Validation result
+ * @throws Error if validation encounters fatal error
+ */
+export async function runValidateWorkflow(config, options) {
+    try {
+        // If --check flag is used, only check validation state without running
+        if (options.check) {
+            const yaml = options.yaml ?? false;
+            const { checkValidationStatus } = await import('./check-validation.js');
+            await checkValidationStatus(config, yaml);
+            // checkValidationStatus calls process.exit, so this line never executes
+            // But TypeScript doesn't know that, so we need to satisfy the return type
+            throw new Error('checkValidationStatus should have exited');
+        }
+        const verbose = options.verbose ?? false;
+        const yaml = options.yaml ?? false;
+        // Create runner config
+        const runnerConfig = createRunnerConfig(config, {
+            force: options.force,
+            verbose,
+            yaml,
+            context: options.context,
+        });
+        // Get tree hash BEFORE validation (for caching and stability check)
+        let treeHashBefore = null;
+        try {
+            treeHashBefore = await getGitTreeHash();
+        }
+        catch (_error) {
+            // Not in git repo or git command failed - continue without history
+            if (verbose) {
+                console.warn(chalk.yellow('⚠️  Could not get git tree hash - history recording disabled'));
+            }
+        }
+        // Check cache: if validation already passed for this tree hash, skip re-running
+        if (treeHashBefore && !options.force) {
+            try {
+                const historyNote = await readHistoryNote(treeHashBefore);
+                if (historyNote && historyNote.runs.length > 0) {
+                    // Find most recent passing run
+                    const passingRun = [...historyNote.runs]
+                        .reverse()
+                        .find(run => run.passed);
+                    if (passingRun) {
+                        if (yaml) {
+                            // YAML mode: Output cached result as YAML to stdout
+                            await new Promise(resolve => setTimeout(resolve, 10));
+                            // Output YAML document separator (RFC 4627)
+                            process.stdout.write('---\n');
+                            process.stdout.write(yamlStringify(passingRun.result));
+                            // Wait for stdout to flush before exiting
+                            await new Promise(resolve => {
+                                if (process.stdout.write('')) {
+                                    resolve();
+                                }
+                                else {
+                                    process.stdout.once('drain', resolve);
+                                }
+                            });
+                        }
+                        else {
+                            // Human-readable mode: Display cache hit message
+                            const durationSecs = (passingRun.duration / 1000).toFixed(1);
+                            console.log(chalk.green('✅ Validation already passed for current working tree'));
+                            console.log(chalk.gray(`   Tree hash: ${treeHashBefore.substring(0, 12)}...`));
+                            console.log(chalk.gray(`   Last validated: ${passingRun.timestamp}`));
+                            console.log(chalk.gray(`   Duration: ${durationSecs}s`));
+                            console.log(chalk.gray(`   Branch: ${passingRun.branch}`));
+                            if (passingRun.result?.phases) {
+                                const totalSteps = passingRun.result.phases.reduce((sum, phase) => sum + (phase.steps?.length || 0), 0);
+                                console.log(chalk.gray(`   Phases: ${passingRun.result.phases.length}, Steps: ${totalSteps}`));
+                            }
+                        }
+                        // Cache hit - return early without calling process.exit
+                        // This allows tests to complete without throwing process.exit errors
+                        // In production, Commander will exit with code 0
+                        // Mark result as from cache so caller knows not to call process.exit
+                        const result = passingRun.result;
+                        result._fromCache = true;
+                        return result;
+                    }
+                }
+            }
+            catch (_error) {
+                // Cache check failed - proceed with validation
+                // This is expected for first-time validation
+            }
+        }
+        // Display tree hash before running validation (debugging/transparency aid)
+        // This goes to stderr, so it's visible even in YAML mode
+        if (treeHashBefore) {
+            console.error(chalk.gray(`🌳 Working tree: ${treeHashBefore.slice(0, 12)}...`));
+            if (!yaml) {
+                console.log(''); // Blank line for readability (human mode only)
+            }
+        }
+        // Run validation
+        const result = await runValidation(runnerConfig);
+        // Record validation history (if in git repo and stability check passes)
+        if (treeHashBefore) {
+            try {
+                // Check if worktree changed during validation
+                const stability = await checkWorktreeStability(treeHashBefore);
+                if (!stability.stable) {
+                    console.warn(chalk.yellow('\n⚠️  Worktree changed during validation'));
+                    console.warn(chalk.yellow(`   Before: ${stability.treeHashBefore.slice(0, 12)}...`));
+                    console.warn(chalk.yellow(`   After:  ${stability.treeHashAfter.slice(0, 12)}...`));
+                    console.warn(chalk.yellow('   Results valid but history not recorded (unstable state)'));
+                }
+                else {
+                    // Record to git notes
+                    const recordResult = await recordValidationHistory(treeHashBefore, result);
+                    if (recordResult.recorded) {
+                        if (verbose) {
+                            console.log(chalk.gray(`\n📝 History recorded (tree: ${treeHashBefore.slice(0, 12)})`));
+                        }
+                    }
+                    else if (verbose) {
+                        console.warn(chalk.yellow(`⚠️  History recording failed: ${recordResult.reason}`));
+                    }
+                }
+            }
+            catch (error) {
+                // Silent failure - don't block validation
+                if (verbose) {
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    console.warn(chalk.yellow(`⚠️  History recording error: ${errorMessage}`));
+                }
+            }
+        }
+        // Proactive health check (non-blocking)
+        try {
+            const health = await checkHistoryHealth();
+            if (health.shouldWarn) {
+                console.log('');
+                console.log(chalk.blue(health.warningMessage));
+            }
+        }
+        catch {
+            // Silent failure - don't block validation
+        }
+        // If validation failed, show agent-friendly error details
+        if (!result.passed) {
+            console.error(chalk.blue('\n📋 View error details:'), chalk.white('vibe-validate state'));
+            if (result.rerunCommand) {
+                console.error(chalk.blue('🔄 To retry:'), chalk.white(result.rerunCommand));
+            }
+            if (result.fullLogFile) {
+                console.error(chalk.blue('📄 Full log:'), chalk.gray(result.fullLogFile));
+            }
+            // Context-aware extraction quality feedback (only when developerFeedback is enabled)
+            if (config.developerFeedback) {
+                // Check if any steps had poor extraction quality
+                const poorExtractionSteps = result.phases
+                    ?.flatMap(phase => phase.steps || [])
+                    .filter(step => !step.passed && step.extractionQuality && step.extractionQuality.score < 50);
+                if (poorExtractionSteps && poorExtractionSteps.length > 0) {
+                    // Detect if we're dogfooding (in the vibe-validate project itself)
+                    const isDogfooding = process.cwd().includes('vibe-validate');
+                    console.error('');
+                    console.error(chalk.yellow('⚠️  Poor extraction quality detected'));
+                    if (isDogfooding) {
+                        // Developing vibe-validate itself: direct contributor call-to-action
+                        console.error(chalk.yellow('   💡 vibe-validate improvement opportunity: Improve extractors in packages/extractors/'));
+                        console.error(chalk.gray('   See packages/extractors/test/samples/ for how to add test cases'));
+                    }
+                    else {
+                        // External project: user feedback to improve vibe-validate
+                        console.error(chalk.yellow('   💡 Help improve vibe-validate by reporting this extraction issue'));
+                        console.error(chalk.gray('   https://github.com/anthropics/vibe-validate/issues/new?template=extractor-improvement.yml'));
+                    }
+                }
+            }
+        }
+        // Output YAML validation result if --yaml flag is set
+        if (yaml) {
+            // Small delay to ensure stderr is flushed before writing to stdout
+            await new Promise(resolve => setTimeout(resolve, 10));
+            // Output YAML document separator (RFC 4627) to mark transition from stderr to stdout
+            process.stdout.write('---\n');
+            // Output pure YAML without headers (workflow provides display framing)
+            process.stdout.write(yamlStringify(result));
+            // CRITICAL: Wait for stdout to flush before exiting
+            // When stdout is redirected to a file (CI), process.exit() can kill the process
+            // before the write buffer is flushed, causing truncated output
+            await new Promise(resolve => {
+                if (process.stdout.write('')) {
+                    // Write buffer is empty, can exit immediately
+                    resolve();
+                }
+                else {
+                    // Wait for drain event
+                    process.stdout.once('drain', resolve);
+                }
+            });
+        }
+        return result;
+    }
+    catch (error) {
+        console.error(chalk.red('❌ Validation failed with error:'), error);
+        // If YAML mode, output error as YAML to stdout for CI extraction
+        if (options.yaml) {
+            const errorResult = {
+                passed: false,
+                timestamp: new Date().toISOString(),
+                error: error instanceof Error ? error.message : String(error),
+                errorStack: error instanceof Error ? error.stack : undefined,
+            };
+            // Small delay to ensure stderr is flushed before writing to stdout
+            await new Promise(resolve => setTimeout(resolve, 10));
+            // Output YAML document separator
+            process.stdout.write('---\n');
+            process.stdout.write(yamlStringify(errorResult));
+            // Wait for stdout to flush before exiting
+            await new Promise(resolve => {
+                if (process.stdout.write('')) {
+                    resolve();
+                }
+                else {
+                    process.stdout.once('drain', resolve);
+                }
+            });
+        }
+        // Re-throw to allow caller to handle exit
+        throw error;
+    }
+}
+//# sourceMappingURL=validate-workflow.js.map