@vibe-validate/cli 0.14.2 → 0.15.0-rc.1

package/dist/utils/temp-files.js

@@ -0,0 +1,202 @@
+/**
+ * Temporary file management utilities
+ *
+ * Provides organized temp directory structure for vibe-validate output files:
+ * - /tmp/vibe-validate/runs/{YYYY-MM-DD}/{shortHash-HH-mm-ss}/
+ * - Cleanup utilities for old temp files
+ * - Storage size calculation
+ */
+import { mkdir, readdir, rm, stat } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+/**
+ * Get the root temporary directory for vibe-validate
+ * @returns Path to /tmp/vibe-validate (or OS equivalent)
+ */
+export function getVibeValidateTempDir() {
+    return join(tmpdir(), 'vibe-validate');
+}
+/**
+ * Get the organized output directory for a specific run
+ * @param treeHash - Git tree hash or identifier
+ * @returns Path like /tmp/vibe-validate/runs/2025-11-05/abc123-17-30-45/
+ */
+export function getRunOutputDir(treeHash) {
+    const now = new Date();
+    // Date folder: YYYY-MM-DD
+    const dateFolder = now.toISOString().split('T')[0];
+    // Short hash: first 6 chars
+    const shortHash = treeHash.substring(0, 6);
+    // Time suffix: HH-mm-ss
+    const timeSuffix = now.toISOString().split('T')[1].substring(0, 8).replace(/:/g, '-');
+    // Combined: abc123-17-30-45
+    const runFolder = `${shortHash}-${timeSuffix}`;
+    return join(getVibeValidateTempDir(), 'runs', dateFolder, runFolder);
+}
+/**
+ * Ensure a directory exists (create if needed)
+ */
+export async function ensureDir(dirPath) {
+    try {
+        await mkdir(dirPath, { recursive: true });
+    }
+    catch (err) {
+        // Ignore if directory already exists
+        if (err && typeof err === 'object' && 'code' in err && err.code !== 'EEXIST') {
+            throw err;
+        }
+    }
+}
+/**
+ * Get the size of a directory recursively (in bytes)
+ */
+async function getDirectorySize(dirPath) {
+    let totalSize = 0;
+    try {
+        const entries = await readdir(dirPath, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = join(dirPath, entry.name);
+            if (entry.isDirectory()) {
+                totalSize += await getDirectorySize(fullPath);
+            }
+            else if (entry.isFile()) {
+                const stats = await stat(fullPath);
+                totalSize += stats.size;
+            }
+        }
+    }
+    catch (err) {
+        // Ignore errors (directory might not exist or be inaccessible)
+        if (err && typeof err === 'object' && 'code' in err && err.code !== 'ENOENT') {
+            // Log unexpected errors but don't throw
+            console.warn(`Warning: Could not read directory ${dirPath}:`, err);
+        }
+    }
+    return totalSize;
+}
+/**
+ * Count the number of run directories
+ */
+async function countRunDirectories(runsDir) {
+    let count = 0;
+    try {
+        const dateDirs = await readdir(runsDir, { withFileTypes: true });
+        for (const dateDir of dateDirs) {
+            if (dateDir.isDirectory()) {
+                const dateDirPath = join(runsDir, dateDir.name);
+                const runDirs = await readdir(dateDirPath, { withFileTypes: true });
+                count += runDirs.filter(d => d.isDirectory()).length;
+            }
+        }
+    }
+    catch (err) {
+        // Ignore errors (directory might not exist)
+        if (err && typeof err === 'object' && 'code' in err && err.code !== 'ENOENT') {
+            console.warn(`Warning: Could not count run directories:`, err);
+        }
+    }
+    return count;
+}
+/**
+ * Get temp file storage information
+ */
+export async function getTempStorageInfo() {
+    const tempDir = getVibeValidateTempDir();
+    const runsDir = join(tempDir, 'runs');
+    const [sizeBytes, runCount] = await Promise.all([
+        getDirectorySize(runsDir),
+        countRunDirectories(runsDir),
+    ]);
+    return {
+        sizeBytes,
+        runCount,
+        path: runsDir,
+    };
+}
+/**
+ * Format bytes as human-readable size
+ */
+export function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const k = 1024;
+    const sizes = ['B', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${(bytes / Math.pow(k, i)).toFixed(1)} ${sizes[i]}`;
+}
+/**
+ * Clean up old temporary files
+ */
+// eslint-disable-next-line sonarjs/cognitive-complexity -- Cleanup logic requires nested loops and error handling for directory traversal
+export async function cleanupOldTempFiles(options = {}) {
+    const { olderThanDays = 7, dryRun = false, deleteAll = false, } = options;
+    const result = {
+        deletedCount: 0,
+        freedBytes: 0,
+        deletedPaths: [],
+        errors: [],
+    };
+    const tempDir = getVibeValidateTempDir();
+    const runsDir = join(tempDir, 'runs');
+    try {
+        const dateDirs = await readdir(runsDir, { withFileTypes: true });
+        const cutoffDate = new Date();
+        cutoffDate.setDate(cutoffDate.getDate() - olderThanDays);
+        for (const dateDir of dateDirs) {
+            if (!dateDir.isDirectory())
+                continue;
+            const dateDirPath = join(runsDir, dateDir.name);
+            try {
+                const runDirs = await readdir(dateDirPath, { withFileTypes: true });
+                for (const runDir of runDirs) {
+                    if (!runDir.isDirectory())
+                        continue;
+                    const runDirPath = join(dateDirPath, runDir.name);
+                    try {
+                        const stats = await stat(runDirPath);
+                        const shouldDelete = deleteAll || stats.mtime < cutoffDate;
+                        if (shouldDelete) {
+                            const dirSize = await getDirectorySize(runDirPath);
+                            if (!dryRun) {
+                                await rm(runDirPath, { recursive: true, force: true });
+                            }
+                            result.deletedCount++;
+                            result.freedBytes += dirSize;
+                            result.deletedPaths.push(runDirPath);
+                        }
+                    }
+                    catch (err) {
+                        const errorMsg = err instanceof Error ? err.message : String(err);
+                        result.errors.push({ path: runDirPath, error: errorMsg });
+                    }
+                }
+                // Try to remove empty date directories
+                if (!dryRun) {
+                    try {
+                        const remaining = await readdir(dateDirPath);
+                        if (remaining.length === 0) {
+                            await rm(dateDirPath, { recursive: true });
+                        }
+                    }
+                    catch {
+                        // Ignore errors when cleaning up empty directories
+                    }
+                }
+            }
+            catch (err) {
+                const errorMsg = err instanceof Error ? err.message : String(err);
+                result.errors.push({ path: dateDirPath, error: errorMsg });
+            }
+        }
+    }
+    catch (err) {
+        if (err && typeof err === 'object' && 'code' in err && err.code === 'ENOENT') {
+            // Runs directory doesn't exist - nothing to clean up
+            return result;
+        }
+        const errorMsg = err instanceof Error ? err.message : String(err);
+        result.errors.push({ path: runsDir, error: errorMsg });
+    }
+    return result;
+}
+//# sourceMappingURL=temp-files.js.map

package/dist/utils/temp-files.js.map

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

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

@@ -1 +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;AA6ED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,IAAI,gBAAgB,EAAE,CAsBtD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAa7C"}
+{"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;AA6ED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,IAAI,gBAAgB,EAAE,CAuBtD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAa7C"}

package/dist/utils/template-discovery.js

@@ -3,9 +3,9 @@
  *
  * 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 { readdirSync, readFileSync, existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { splitLines } from './normalize-line-endings.js';
 /**
  * Get the absolute path to the config-templates directory
@@ -51,7 +51,7 @@ function parseTemplateMetadata(filename, content) {
     let displayName = filename.replace('.yaml', '');
     const titleLine = lines.find(line => line.includes('CONFIGURATION TEMPLATE -'));
     if (titleLine) {
-        const match = titleLine.match(/CONFIGURATION TEMPLATE\s*-\s*(.+)/);
+        const match = /CONFIGURATION TEMPLATE\s*-\s*(.+)/.exec(titleLine);
         if (match) {
             displayName = match[1].trim();
             // Remove "vibe-validate for " prefix if present
@@ -91,6 +91,7 @@ export function discoverTemplates() {
     // Read all .yaml files
     const files = readdirSync(templatesDir)
         .filter(file => file.endsWith('.yaml'))
+        // eslint-disable-next-line sonarjs/no-alphabetical-sort -- Alphabetical sorting is intentional for template list display
         .sort();
     // Parse metadata from each template
     const templates = [];

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

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

@@ -1 +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"}
+{"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;AAmLD;;;;;;;;;GASG;AAEH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,gBAAgB,CAAC,CAgG3B"}

package/dist/utils/validate-workflow.js

@@ -10,6 +10,162 @@ import { recordValidationHistory, checkWorktreeStability, checkHistoryHealth, re
 import { createRunnerConfig } from './runner-adapter.js';
 import chalk from 'chalk';
 import { stringify as yamlStringify } from 'yaml';
+/**
+ * Wait for stdout to flush before continuing
+ *
+ * Critical for YAML output when stdout is redirected to a file (CI).
+ * Without this, process.exit() can kill the process before the write buffer flushes.
+ *
+ * @internal
+ */
+async function flushStdout() {
+    await new Promise(resolve => {
+        if (process.stdout.write('')) {
+            resolve();
+        }
+        else {
+            process.stdout.once('drain', resolve);
+        }
+    });
+}
+/**
+ * Output validation result as YAML
+ *
+ * @param result - Validation result to output
+ * @internal
+ */
+async function outputYaml(result) {
+    // Small delay to ensure stderr is flushed before writing to stdout
+    await new Promise(resolve => setTimeout(resolve, 10));
+    // Output YAML document separator (RFC 4627)
+    process.stdout.write('---\n');
+    process.stdout.write(yamlStringify(result));
+    await flushStdout();
+}
+/**
+ * Check cache for passing validation run
+ *
+ * @param treeHash - Git tree hash to check
+ * @param yaml - Whether YAML output mode is enabled
+ * @returns Cached result if found, null otherwise
+ * @internal
+ */
+async function checkCache(treeHash, yaml) {
+    try {
+        const historyNote = await readHistoryNote(treeHash);
+        if (historyNote && historyNote.runs.length > 0) {
+            // Find most recent passing run
+            const passingRun = [...historyNote.runs]
+                .reverse()
+                .find(run => run.passed);
+            if (passingRun) {
+                // Mark result as from cache (v0.15.0+ schema field)
+                const result = passingRun.result;
+                result.isCachedResult = true;
+                if (yaml) {
+                    await outputYaml(result);
+                }
+                else {
+                    const durationSecs = (passingRun.duration / 1000).toFixed(1);
+                    console.log(chalk.green('✅ Validation already passed for current working tree'));
+                    console.log(chalk.gray(`   Tree hash: ${treeHash.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);
+                        console.log(chalk.gray(`   Phases: ${passingRun.result.phases.length}, Steps: ${totalSteps}`));
+                    }
+                }
+                return result;
+            }
+        }
+    }
+    catch {
+        // Cache check failed - proceed with validation
+    }
+    return null;
+}
+/**
+ * Record validation history with stability check
+ *
+ * @param treeHashBefore - Tree hash before validation
+ * @param result - Validation result to record
+ * @param verbose - Whether verbose output is enabled
+ * @internal
+ */
+async function recordHistory(treeHashBefore, result, verbose) {
+    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}`));
+        }
+    }
+}
+/**
+ * Display failure information and extraction quality feedback
+ *
+ * @param result - Validation result (failed)
+ * @param config - Vibe validate configuration
+ * @internal
+ */
+function displayFailureInfo(result, config) {
+    console.error(chalk.blue('\n📋 View error details:'), chalk.white('vibe-validate state'));
+    // Find the failed step's command (v0.15.0+: rerunCommand removed, use step.command)
+    const failedStep = result.phases
+        ?.flatMap(phase => phase.steps)
+        .find(step => step.name === result.failedStep);
+    if (failedStep?.command) {
+        console.error(chalk.blue('🔄 To retry:'), chalk.white(failedStep.command));
+    }
+    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) {
+        const poorExtractionSteps = result.phases
+            ?.flatMap(phase => phase.steps)
+            .filter(step => !step.passed && step.extraction?.metadata && step.extraction.metadata.confidence < 50);
+        if (poorExtractionSteps && poorExtractionSteps.length > 0) {
+            // VV_CONTEXT is set by the smart wrapper (vibe-validate/vv)
+            // 'dev' = developer mode (working on vibe-validate itself)
+            const isDevMode = process.env.VV_CONTEXT === 'dev';
+            console.error('');
+            console.error(chalk.yellow('⚠️  Poor extraction quality detected'));
+            if (isDevMode) {
+                console.error(chalk.yellow('   💡 Developer mode: Improve extractors in packages/extractors/'));
+                console.error(chalk.gray('   See packages/extractors/test/samples/ for how to add test cases'));
+            }
+            else {
+                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'));
+            }
+        }
+    }
+}
 /**
  * Execute validation workflow with caching, history recording, and output formatting.
  *
@@ -20,6 +176,7 @@ import { stringify as yamlStringify } from 'yaml';
  * @returns Validation result
  * @throws Error if validation encounters fatal error
  */
+// eslint-disable-next-line sonarjs/cognitive-complexity -- Complexity 27 acceptable for workflow orchestration (down from 81) - coordinates caching, validation, history recording, and output formatting
 export async function runValidateWorkflow(config, options) {
     try {
         // If --check flag is used, only check validation state without running
@@ -27,8 +184,6 @@ export async function runValidateWorkflow(config, options) {
             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;
@@ -45,68 +200,20 @@ export async function runValidateWorkflow(config, options) {
         try {
             treeHashBefore = await getGitTreeHash();
         }
-        catch (_error) {
-            // Not in git repo or git command failed - continue without history
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
             if (verbose) {
-                console.warn(chalk.yellow('⚠️  Could not get git tree hash - history recording disabled'));
+                console.warn(chalk.yellow(`⚠️  Could not get git tree hash - history recording disabled: ${errorMsg}`));
             }
         }
         // 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
+            const cachedResult = await checkCache(treeHashBefore, yaml);
+            if (cachedResult) {
+                return cachedResult;
             }
         }
-        // Display tree hash before running validation (debugging/transparency aid)
-        // This goes to stderr, so it's visible even in YAML mode
+        // Display tree hash before running validation
         if (treeHashBefore) {
             console.error(chalk.gray(`🌳 Working tree: ${treeHashBefore.slice(0, 12)}...`));
             if (!yaml) {
@@ -115,37 +222,9 @@ export async function runValidateWorkflow(config, options) {
         }
         // Run validation
         const result = await runValidation(runnerConfig);
-        // Record validation history (if in git repo and stability check passes)
+        // Record validation history (if in git repo)
         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}`));
-                }
-            }
+            await recordHistory(treeHashBefore, result, verbose);
         }
         // Proactive health check (non-blocking)
         try {
@@ -160,58 +239,11 @@ export async function runValidateWorkflow(config, options) {
         }
         // 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'));
-                    }
-                }
-            }
+            displayFailureInfo(result, config);
         }
         // 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);
-                }
-            });
+            await outputYaml(result);
         }
         return result;
     }
@@ -225,20 +257,7 @@ export async function runValidateWorkflow(config, options) {
                 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);
-                }
-            });
+            await outputYaml(errorResult);
         }
         // Re-throw to allow caller to handle exit
         throw error;