@vibe-validate/cli 0.11.0 → 0.12.0

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

@@ -1,155 +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';
-import { splitLines } from '../normalize-line-endings.js';
-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 = splitLines(content)
-            .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 = splitLines(content)
-            .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/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

package/dist/utils/validate-workflow.js.map

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

package/dist/utils/validation-cache.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Validation Cache Utility
+ *
+ * Provides git tree hash-based caching for validation results.
+ * Used by both validate and pre-commit commands to avoid redundant validation.
+ */
+import type { ValidationResult } from '@vibe-validate/core';
+export interface CacheCheckResult {
+    /** Whether a cached passing result was found */
+    cacheHit: boolean;
+    /** The git tree hash that was checked */
+    treeHash: string | null;
+    /** The cached validation result (if cache hit) */
+    cachedResult?: ValidationResult;
+    /** Metadata about the cached run */
+    cachedRun?: {
+        timestamp: string;
+        duration: number;
+        branch: string;
+    };
+}
+/**
+ * Check if validation has already passed for the current working tree.
+ * Returns cache hit info including the cached result if found.
+ *
+ * @param force - If true, bypass cache and force re-validation
+ * @returns Cache check result with tree hash and optional cached result
+ */
+export declare function checkValidationCache(force?: boolean): Promise<CacheCheckResult>;
+//# sourceMappingURL=validation-cache.d.ts.map

package/dist/utils/validation-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-cache.d.ts","sourceRoot":"","sources":["../../src/utils/validation-cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,QAAQ,EAAE,OAAO,CAAC;IAElB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,kDAAkD;IAClD,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAEhC,oCAAoC;IACpC,SAAS,CAAC,EAAE;QACV,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,UAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA2CnF"}

package/dist/utils/validation-cache.js

@@ -0,0 +1,57 @@
+/**
+ * Validation Cache Utility
+ *
+ * Provides git tree hash-based caching for validation results.
+ * Used by both validate and pre-commit commands to avoid redundant validation.
+ */
+import { getGitTreeHash } from '@vibe-validate/git';
+import { readHistoryNote } from '@vibe-validate/history';
+/**
+ * Check if validation has already passed for the current working tree.
+ * Returns cache hit info including the cached result if found.
+ *
+ * @param force - If true, bypass cache and force re-validation
+ * @returns Cache check result with tree hash and optional cached result
+ */
+export async function checkValidationCache(force = false) {
+    // Get tree hash for current working directory
+    let treeHash = null;
+    try {
+        treeHash = await getGitTreeHash();
+    }
+    catch (_error) {
+        // Not in git repo or git command failed
+        return { cacheHit: false, treeHash: null };
+    }
+    // If force flag set, skip cache check
+    if (force) {
+        return { cacheHit: false, treeHash };
+    }
+    // Check git notes for cached validation result
+    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 && passingRun.result) {
+                return {
+                    cacheHit: true,
+                    treeHash,
+                    cachedResult: passingRun.result,
+                    cachedRun: {
+                        timestamp: passingRun.timestamp,
+                        duration: passingRun.duration,
+                        branch: passingRun.branch,
+                    },
+                };
+            }
+        }
+    }
+    catch (_error) {
+        // Cache read failed - proceed without cache
+    }
+    return { cacheHit: false, treeHash };
+}
+//# sourceMappingURL=validation-cache.js.map

package/dist/utils/validation-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-cache.js","sourceRoot":"","sources":["../../src/utils/validation-cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAqBzD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,KAAK,GAAG,KAAK;IACtD,8CAA8C;IAC9C,IAAI,QAAQ,GAAkB,IAAI,CAAC;IACnC,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,cAAc,EAAE,CAAC;IACpC,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,wCAAwC;QACxC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC7C,CAAC;IAED,sCAAsC;IACtC,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IACvC,CAAC;IAED,+CAA+C;IAC/C,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;QAEpD,IAAI,WAAW,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/C,+BAA+B;YAC/B,MAAM,UAAU,GAAG,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC;iBACrC,OAAO,EAAE;iBACT,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAE3B,IAAI,UAAU,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;gBACpC,OAAO;oBACL,QAAQ,EAAE,IAAI;oBACd,QAAQ;oBACR,YAAY,EAAE,UAAU,CAAC,MAAM;oBAC/B,SAAS,EAAE;wBACT,SAAS,EAAE,UAAU,CAAC,SAAS;wBAC/B,QAAQ,EAAE,UAAU,CAAC,QAAQ;wBAC7B,MAAM,EAAE,UAAU,CAAC,MAAM;qBAC1B;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,4CAA4C;IAC9C,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AACvC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-validate/cli",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Command-line interface for vibe-validate validation framework",
   "type": "module",
   "main": "./dist/index.js",
@@ -20,6 +20,14 @@
     "watch-pr-result.schema.json",
     "README.md"
   ],
+  "scripts": {
+    "build": "tsc && node dist/scripts/generate-watch-pr-schema.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/ --max-warnings 0"
+  },
   "keywords": [
     "validation",
     "testing",
@@ -54,26 +62,20 @@
     "access": "public"
   },
   "dependencies": {
+    "@vibe-validate/config": "workspace:*",
+    "@vibe-validate/core": "workspace:*",
+    "@vibe-validate/extractors": "workspace:*",
+    "@vibe-validate/git": "workspace:*",
+    "@vibe-validate/history": "workspace:*",
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
     "yaml": "^2.6.1",
     "zod": "^3.24.1",
-    "zod-to-json-schema": "^3.24.6",
-    "@vibe-validate/config": "0.11.0",
-    "@vibe-validate/git": "0.11.0",
-    "@vibe-validate/core": "0.11.0"
+    "zod-to-json-schema": "^3.24.6"
   },
   "devDependencies": {
     "@types/node": "^20.14.8",
     "typescript": "^5.5.2",
     "vitest": "^2.0.5"
-  },
-  "scripts": {
-    "build": "tsc && node dist/scripts/generate-watch-pr-schema.js",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "typecheck": "tsc --noEmit",
-    "lint": "eslint src/ --max-warnings 0"
   }
-}
+}

package/watch-pr-result.schema.json

@@ -103,7 +103,7 @@
               "errorSummary": {
                 "type": "string"
               },
-              "stateFile": {
+              "validationResult": {
                 "type": "object",
                 "properties": {
                   "passed": {